lab/how-to-write-makefile
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity

deploy: 149bca7253d262f589f3429564c40f59d3924214

Browse Source
This commit is contained in:
github-actions[bot] 2022-05-22 04:09:41 +00:00
commit e90d6019d4
67 changed files with 25180 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

4
.buildinfo Normal file
View File

@ -0,0 +1,4 @@
# Sphinx build info version 1
# This file hashes the configuration used when building these files. When it is not found, a full rebuild will be done.
config: d05d5ce156d545875627787049f6b574
tags: 645f666f9bcd5a90fca523b33c5a78b7

0
.nojekyll Normal file
View File

77
_sources/archives.rst.txt Normal file
View File

@ -0,0 +1,77 @@
使用make更新函数库文件
======================
函数库文件也就是对Object文件（程序编译的中间文件）的打包文件。在Unix下，一般是由
命令 ``ar`` 来完成打包工作。
函数库文件的成员
----------------
一个函数库文件由多个文件组成。你可以用如下格式指定函数库文件及其组成::
archive(member)
这个不是一个命令，而一个目标和依赖的定义。一般来说，这种用法基本上就是为了
``ar`` 命令来服务的。如::
foolib(hack.o) : hack.o
ar cr foolib hack.o
如果要指定多个member，那就以空格分开，如::
foolib(hack.o kludge.o)
其等价于::
foolib(hack.o) foolib(kludge.o)
你还可以使用Shell的文件通配符来定义，如::
foolib(*.o)
函数库成员的隐含规则
--------------------
当make搜索一个目标的隐含规则时，一个特殊的特性是，如果这个目标是 ``a(m)`` 形式
的，其会把目标变成 ``(m)`` 。于是，如果我们的成员是 ``%.o`` 的模式定义，并且如果
我们使用 ``make foo.a(bar.o)`` 的形式调用Makefile时，隐含规则会去找 ``bar.o`` 的
规则，如果没有定义 ``bar.o`` 的规则，那么内建隐含规则生效，make会去找 ``bar.c``
文件来生成 ``bar.o`` ，如果找得到的话，make执行的命令大致如下::
cc -c bar.c -o bar.o
ar r foo.a bar.o
rm -f bar.o
还有一个变量要注意的是 ``$%`` ，这是专属函数库文件的自动化变量，有关其说明请参
见“自动化变量”一节。
函数库文件的后缀规则
--------------------
你可以使用“后缀规则”和“隐含规则”来生成函数库打包文件，如：
.. code-block:: makefile
.c.a:
$(CC) $(CFLAGS) $(CPPFLAGS) -c $< -o $*.o
$(AR) r $@ $*.o
$(RM) $*.o
其等效于：
.. code-block:: makefile
(%.o) : %.c
$(CC) $(CFLAGS) $(CPPFLAGS) -c $< -o $*.o
$(AR) r $@ $*.o
$(RM) $*.o
注意事项
--------
在进行函数库打包文件生成时，请小心使用make的并行机制（ ``-j`` 参数）。如果多个
``ar`` 命令在同一时间运行在同一个函数库打包文件上，就很有可以损坏这个函数库文件
。所以，在make未来的版本中，应该提供一种机制来避免并行操作发生在函数打包文件上。
但就目前而言，你还是应该不要尽量不要使用 ``-j`` 参数。

162
_sources/conditionals.rst.txt Normal file
View File

@ -0,0 +1,162 @@
使用条件判断
============
使用条件判断，可以让make根据运行时的不同情况选择不同的执行分支。条件表达式可以是比较变量的值，
或是比较变量和常量的值。
示例
----
下面的例子，判断 ``$(CC)`` 变量是否 ``gcc`` ，如果是的话，则使用GNU函数编译目标。
.. code-block:: makefile
libs_for_gcc = -lgnu
normal_libs =
foo: $(objects)
ifeq ($(CC),gcc)
$(CC) -o foo $(objects) $(libs_for_gcc)
else
$(CC) -o foo $(objects) $(normal_libs)
endif
可见，在上面示例的这个规则中，目标 ``foo`` 可以根据变量 ``$(CC)`` 值来选取不同的函数库来
编译程序。
我们可以从上面的示例中看到三个关键字： ``ifeq`` 、 ``else`` 和 ``endif`` 。 ``ifeq`` 的
意思表示条件语句的开始，并指定一个条件表达式，表达式包含两个参数，以逗号分隔，表达式以圆括号括
起。 ``else`` 表示条件表达式为假的情况。 ``endif`` 表示一个条件语句的结束，任何一个条件表达
式都应该以 ``endif`` 结束。
当我们的变量 ``$(CC)`` 值是 ``gcc`` 时，目标 ``foo`` 的规则是：
.. code-block:: makefile
foo: $(objects)
$(CC) -o foo $(objects) $(libs_for_gcc)
而当我们的变量 ``$(CC)`` 值不是 ``gcc`` 时（比如 ``cc`` ），目标 ``foo`` 的规则是：
.. code-block:: makefile
foo: $(objects)
$(CC) -o foo $(objects) $(normal_libs)
当然，我们还可以把上面的那个例子写得更简洁一些：
.. code-block:: makefile
libs_for_gcc = -lgnu
normal_libs =
ifeq ($(CC),gcc)
libs=$(libs_for_gcc)
else
libs=$(normal_libs)
endif
foo: $(objects)
$(CC) -o foo $(objects) $(libs)
语法
----
条件表达式的语法为::
<conditional-directive>
<text-if-true>
endif
以及::
<conditional-directive>
<text-if-true>
else
<text-if-false>
endif
其中 ``<conditional-directive>`` 表示条件关键字，如 ``ifeq`` 。这个关键字有四个。
第一个是我们前面所见过的 ``ifeq``
.. code-block:: makefile
ifeq (<arg1>, <arg2>)
ifeq '<arg1>' '<arg2>'
ifeq "<arg1>" "<arg2>"
ifeq "<arg1>" '<arg2>'
ifeq '<arg1>' "<arg2>"
比较参数 ``arg1`` 和 ``arg2`` 的值是否相同。当然，参数中我们还可以使用make的函数。如::
ifeq ($(strip $(foo)),)
<text-if-empty>
endif
这个示例中使用了 ``strip`` 函数，如果这个函数的返回值是空（Empty），那么
``<text-if-empty>`` 就生效。
第二个条件关键字是 ``ifneq`` 。语法是：
.. code-block:: makefile
ifneq (<arg1>, <arg2>)
ifneq '<arg1>' '<arg2>'
ifneq "<arg1>" "<arg2>"
ifneq "<arg1>" '<arg2>'
ifneq '<arg1>' "<arg2>"
其比较参数 ``arg1`` 和 ``arg2`` 的值是否相同，如果不同，则为真。和 ``ifeq`` 类似。
第三个条件关键字是 ``ifdef`` 。语法是：
.. code-block:: makefile
ifdef <variable-name>
如果变量 ``<variable-name>`` 的值非空，那到表达式为真。否则，表达式为假。当然，
``<variable-name>`` 同样可以是一个函数的返回值。注意， ``ifdef`` 只是测试一个变量
是否有值，其并不会把变量扩展到当前位置。还是来看两个例子：
示例一：
.. code-block:: makefile
bar =
foo = $(bar)
ifdef foo
frobozz = yes
else
frobozz = no
endif
示例二：
.. code-block:: makefile
foo =
ifdef foo
frobozz = yes
else
frobozz = no
endif
第一个例子中， ``$(frobozz)`` 值是 ``yes`` ，第二个则是 ``no``。
第四个条件关键字是 ``ifndef`` 。其语法是：
.. code-block:: makefile
ifndef <variable-name>
这个我就不多说了，和 ``ifdef`` 是相反的意思。
在 ``<conditional-directive>`` 这一行上，多余的空格是被允许的，但是不能以 ``Tab`` 键
作为开始（不然就被认为是命令）。而注释符 ``#`` 同样也是安全的。 ``else`` 和 ``endif``
也一样，只要不是以 ``Tab`` 键开始就行了。
特别注意的是，make是在读取Makefile时就计算条件表达式的值，并根据条件表达式的值来选择语句，
所以，你最好不要把自动化变量（如 ``$@`` 等）放入条件表达式中，因为自动化变量是在运行时才有的。
而且为了避免混乱，make不允许把整个条件语句分成两部分放在不同的文件中。

546
_sources/functions.rst.txt Normal file
View File

@ -0,0 +1,546 @@
使用函数
========
在Makefile中可以使用函数来处理变量，从而让我们的命令或是规则更为的灵活和具有智能。make
所支持的函数也不算很多，不过已经足够我们的操作了。函数调用后，函数的返回值可以当做变量来使用。
函数的调用语法
--------------
函数调用，很像变量的使用，也是以 ``$`` 来标识的，其语法如下：
.. code-block:: makefile
$(<function> <arguments>)
或是::
${<function> <arguments>}
这里， ``<function>`` 就是函数名，make支持的函数不多。 ``<arguments>`` 为函数的参数，
参数间以逗号 ``,`` 分隔，而函数名和参数之间以“空格”分隔。函数调用以 ``$`` 开头，以圆括号
或花括号把函数名和参数括起。感觉很像一个变量，是不是？函数中的参数可以使用变量，为了风格的
统一，函数和变量的括号最好一样，如使用 ``$(subst a,b,$(x))`` 这样的形式，而不是
``$(subst a,b, ${x})`` 的形式。因为统一会更清楚，也会减少一些不必要的麻烦。
还是来看一个示例：
.. code-block:: makefile
comma:= ,
empty:=
space:= $(empty) $(empty)
foo:= a b c
bar:= $(subst $(space),$(comma),$(foo))
在这个示例中， ``$(comma)`` 的值是一个逗号。 ``$(space)`` 使用了 ``$(empty)`` 定义了
一个空格， ``$(foo)`` 的值是 ``a b c`` ， ``$(bar)`` 的定义用，调用了函数 ``subst`` ，
这是一个替换函数，这个函数有三个参数，第一个参数是被替换字串，第二个参数是替换字串，第三个参数
是替换操作作用的字串。这个函数也就是把 ``$(foo)`` 中的空格替换成逗号，所以 ``$(bar)`` 的值
是 ``a,b,c`` 。
字符串处理函数
--------------
subst
~~~~~
.. code-block:: makefile
$(subst <from>,<to>,<text>)
- 名称：字符串替换函数
- 功能：把字串 ``<text>`` 中的 ``<from>`` 字符串替换成 ``<to>`` 。
- 返回：函数返回被替换过后的字符串。
- 示例：
.. code-block:: makefile
$(subst ee,EE,feet on the street)
把 ``feet on the street`` 中的 ``ee`` 替换成 ``EE`` ，返回结果是 ``fEEt on the strEEt`` 。
patsubst
~~~~~~~~
.. code-block:: makefile
$(patsubst <pattern>,<replacement>,<text>)
- 名称：模式字符串替换函数。
- 功能：查找 ``<text>`` 中的单词（单词以“空格”、“Tab”或“回车”“换行”分隔）是否符合模式
``<pattern>`` ，如果匹配的话，则以 ``<replacement>`` 替换。这里， ``<pattern>`` 可以
包括通配符 ``%`` ，表示任意长度的字串。如果 ``<replacement>`` 中也包含 ``%`` ，那么，
``<replacement>`` 中的这个 ``%`` 将是 ``<pattern>`` 中的那个 ``%`` 所代表的字串。
（可以用 ``\`` 来转义，以 ``\%`` 来表示真实含义的 ``%`` 字符）
- 返回：函数返回被替换过后的字符串。
- 示例：
.. code-block:: makefile
$(patsubst %.c,%.o,x.c.c bar.c)
把字串 ``x.c.c bar.c`` 符合模式 ``%.c`` 的单词替换成 ``%.o`` ，返回结果是
``x.c.o bar.o``
- 备注：这和我们前面“变量章节”说过的相关知识有点相似。如
``$(var:<pattern>=<replacement>;)`` 相当于
``$(patsubst <pattern>,<replacement>,$(var))`` ，而
``$(var: <suffix>=<replacement>)`` 则相当于
``$(patsubst %<suffix>,%<replacement>,$(var))`` 。
例如有::
objects = foo.o bar.o baz.o，
那么， ``$(objects:.o=.c)`` 和 ``$(patsubst %.o,%.c,$(objects))`` 是一样的。
strip
~~~~~
.. code-block:: makefile
$(strip <string>)
- 名称：去空格函数。
- 功能：去掉 ``<string>`` 字串中开头和结尾的空字符。
- 返回：返回被去掉空格的字符串值。
- 示例：
.. code-block:: makefile
$(strip a b c )
把字串 |abc| 去掉开头和结尾的空格，结果是 ``a b c``。
.. |abc| raw:: html
<code class="docutils literal notranslate"><span class="pre">a b c&nbsp;</span></code>
findstring
~~~~~~~~~~
.. code-block:: makefile
$(findstring <find>,<in>)
- 名称：查找字符串函数
- 功能：在字串 ``<in>`` 中查找 ``<find>`` 字串。
- 返回：如果找到，那么返回 ``<find>`` ，否则返回空字符串。
- 示例：
.. code-block:: makefile
$(findstring a,a b c)
$(findstring a,b c)
第一个函数返回 ``a`` 字符串，第二个返回空字符串
filter
~~~~~~
.. code-block:: makefile
$(filter <pattern...>,<text>)
- 名称：过滤函数
- 功能：以 ``<pattern>`` 模式过滤 ``<text>`` 字符串中的单词，保留符合模式
``<pattern>`` 的单词。可以有多个模式。
- 返回：返回符合模式 ``<pattern>`` 的字串。
- 示例：
.. code-block:: makefile
sources := foo.c bar.c baz.s ugh.h
foo: $(sources)
cc $(filter %.c %.s,$(sources)) -o foo
``$(filter %.c %.s,$(sources))`` 返回的值是 ``foo.c bar.c baz.s`` 。
filter-out
~~~~~~~~~~
.. code-block:: makefile
$(filter-out <pattern...>,<text>)
- 名称：反过滤函数
- 功能：以 ``<pattern>`` 模式过滤 ``<text>`` 字符串中的单词，去除符合模式
``<pattern>`` 的单词。可以有多个模式。
- 返回：返回不符合模式 ``<pattern>`` 的字串。
- 示例：
.. code-block:: makefile
objects=main1.o foo.o main2.o bar.o
mains=main1.o main2.o
``$(filter-out $(mains),$(objects))`` 返回值是 ``foo.o bar.o`` 。
sort
~~~~
.. code-block:: makefile
$(sort <list>)
- 名称：排序函数
- 功能：给字符串 ``<list>`` 中的单词排序（升序）。
- 返回：返回排序后的字符串。
- 示例： ``$(sort foo bar lose)`` 返回 ``bar foo lose`` 。
- 备注： ``sort`` 函数会去掉 ``<list>`` 中相同的单词。
word
~~~~
.. code-block:: makefile
$(word <n>,<text>)
- 名称：取单词函数
- 功能：取字符串 ``<text>`` 中第 ``<n>`` 个单词。（从一开始）
- 返回：返回字符串 ``<text>`` 中第 ``<n>`` 个单词。如果 ``<n>`` 比 ``<text>`` 中的
单词数要大，那么返回空字符串。
- 示例： ``$(word 2, foo bar baz)`` 返回值是 ``bar`` 。
wordlist
~~~~~~~~
.. code-block:: makefile
$(wordlist <ss>,<e>,<text>)
- 名称：取单词串函数
- 功能：从字符串 ``<text>`` 中取从 ``<ss>`` 开始到 ``<e>`` 的单词串。 ``<ss>``
和 ``<e>`` 是一个数字。
- 返回：返回字符串 ``<text>`` 中从 ``<ss>`` 到 ``<e>`` 的单词字串。如果 ``<ss>``
比 ``<text>`` 中的单词数要大，那么返回空字符串。如果 ``<e>`` 大于 ``<text>`` 的单词数，
那么返回从 ``<ss>`` 开始，到 ``<text>`` 结束的单词串。
- 示例： ``$(wordlist 2, 3, foo bar baz)`` 返回值是 ``bar baz`` 。
words
~~~~~
.. code-block:: makefile
$(words <text>)
- 名称：单词个数统计函数
- 功能：统计 ``<text>`` 中字符串中的单词个数。
- 返回：返回 ``<text>`` 中的单词数。
- 示例： ``$(words, foo bar baz)`` 返回值是 ``3`` 。
- 备注：如果我们要取 ``<text>`` 中最后的一个单词，我们可以这样：
``$(word $(words <text>),<text>)`` 。
firstword
~~~~~~~~~
.. code-block:: makefile
$(firstword <text>)
- 名称：首单词函数——firstword。
- 功能：取字符串 ``<text>`` 中的第一个单词。
- 返回：返回字符串 ``<text>`` 的第一个单词。
- 示例： ``$(firstword foo bar)`` 返回值是 ``foo``。
- 备注：这个函数可以用 ``word`` 函数来实现： ``$(word 1,<text>)`` 。
以上，是所有的字符串操作函数，如果搭配混合使用，可以完成比较复杂的功能。这里，举一个现实中
应用的例子。我们知道，make使用 ``VPATH`` 变量来指定“依赖文件”的搜索路径。于是，我们可以
利用这个搜索路径来指定编译器对头文件的搜索路径参数 ``CFLAGS`` ，如：
.. code-block:: makefile
override CFLAGS += $(patsubst %,-I%,$(subst :, ,$(VPATH)))
如果我们的 ``$(VPATH)`` 值是 ``src:../headers`` ，那么
``$(patsubst %,-I%,$(subst :, ,$(VPATH)))`` 将返回 ``-Isrc -I../headers`` ，
这正是cc或gcc搜索头文件路径的参数。
文件名操作函数
--------------
下面我们要介绍的函数主要是处理文件名的。每个函数的参数字符串都会被当做一个或是一系列的文件名
来对待。
dir
~~~
.. code-block:: makefile
$(dir <names...>)
- 名称：取目录函数——dir。
- 功能：从文件名序列 ``<names>`` 中取出目录部分。目录部分是指最后一个反斜杠（ ``/`` ）之前
的部分。如果没有反斜杠，那么返回 ``./`` 。
- 返回：返回文件名序列 ``<names>`` 的目录部分。
- 示例： ``$(dir src/foo.c hacks)`` 返回值是 ``src/ ./`` 。
notdir
~~~~~~
.. code-block:: makefile
$(notdir <names...>)
- 名称：取文件函数——notdir。
- 功能：从文件名序列 ``<names>`` 中取出非目录部分。非目录部分是指最後一个反斜杠（ ``/`` ）
之后的部分。
- 返回：返回文件名序列 ``<names>`` 的非目录部分。
- 示例: ``$(notdir src/foo.c hacks)`` 返回值是 ``foo.c hacks`` 。
suffix
~~~~~~
.. code-block:: makefile
$(suffix <names...>)
- 名称：取後缀函数——suffix。
- 功能：从文件名序列 ``<names>`` 中取出各个文件名的后缀。
- 返回：返回文件名序列 ``<names>`` 的后缀序列，如果文件没有后缀，则返回空字串。
- 示例： ``$(suffix src/foo.c src-1.0/bar.c hacks)`` 返回值是 ``.c .c``。
basename
~~~~~~~~
.. code-block:: makefile
$(basename <names...>)
- 名称：取前缀函数——basename。
- 功能：从文件名序列 ``<names>`` 中取出各个文件名的前缀部分。
- 返回：返回文件名序列 ``<names>`` 的前缀序列，如果文件没有前缀，则返回空字串。
- 示例： ``$(basename src/foo.c src-1.0/bar.c hacks)`` 返回值是
``src/foo src-1.0/bar hacks`` 。
addsuffix
~~~~~~~~~
.. code-block:: makefile
$(addsuffix <suffix>,<names...>)
- 名称：加后缀函数——addsuffix。
- 功能：把后缀 ``<suffix>`` 加到 ``<names>`` 中的每个单词后面。
- 返回：返回加过后缀的文件名序列。
- 示例： ``$(addsuffix .c,foo bar)`` 返回值是 ``foo.c bar.c`` 。
addprefix
~~~~~~~~~
.. code-block:: makefile
$(addprefix <prefix>,<names...>)
- 名称：加前缀函数——addprefix。
- 功能：把前缀 ``<prefix>`` 加到 ``<names>`` 中的每个单词前面。
- 返回：返回加过前缀的文件名序列。
- 示例： ``$(addprefix src/,foo bar)`` 返回值是 ``src/foo src/bar`` 。
join
~~~~
.. code-block:: makefile
$(join <list1>,<list2>)
- 名称：连接函数——join。
- 功能：把 ``<list2>`` 中的单词对应地加到 ``<list1>`` 的单词后面。如果 ``<list1>`` 的
单词个数要比 ``<list2>`` 的多，那么， ``<list1>`` 中的多出来的单词将保持原样。如果
``<list2>`` 的单词个数要比 ``<list1>`` 多，那么， ``<list2>`` 多出来的单词将被复制到
``<list1>`` 中。
- 返回：返回连接过后的字符串。
- 示例： ``$(join aaa bbb , 111 222 333)`` 返回值是 ``aaa111 bbb222 333`` 。
foreach 函数
------------
foreach函数和别的函数非常的不一样。因为这个函数是用来做循环用的，Makefile中的foreach函数
几乎是仿照于Unix标准Shell（/bin/sh）中的for语句，或是C-Shell（/bin/csh）中的foreach语句
而构建的。它的语法是：
.. code-block:: makefile
$(foreach <var>,<list>,<text>)
这个函数的意思是，把参数 ``<list>`` 中的单词逐一取出放到参数 ``<var>`` 所指定的变量中，
然后再执行 ``<text>`` 所包含的表达式。每一次 ``<text>`` 会返回一个字符串，循环过程中，
``<text>`` 的所返回的每个字符串会以空格分隔，最后当整个循环结束时， ``<text>`` 所返回的
每个字符串所组成的整个字符串（以空格分隔）将会是foreach函数的返回值。
所以， ``<var>`` 最好是一个变量名， ``<list>`` 可以是一个表达式，而 ``<text>`` 中一般会
使用 ``<var>`` 这个参数来依次枚举 ``<list>`` 中的单词。举个例子：
.. code-block:: makefile
names := a b c d
files := $(foreach n,$(names),$(n).o)
上面的例子中， ``$(name)`` 中的单词会被挨个取出，并存到变量 ``n`` 中， ``$(n).o`` 每次
根据 ``$(n)`` 计算出一个值，这些值以空格分隔，最后作为foreach函数的返回，所以， ``$(files)``
的值是 ``a.o b.o c.o d.o`` 。
注意，foreach中的 ``<var>`` 参数是一个临时的局部变量，foreach函数执行完后，参数 ``<var>``
的变量将不在作用，其作用域只在foreach函数当中。
if 函数
-------
if函数很像GNU的make所支持的条件语句——ifeq（参见前面所述的章节），if函数的语法是：
.. code-block:: makefile
$(if <condition>,<then-part>)
或是
.. code-block:: makefile
$(if <condition>,<then-part>,<else-part>)
可见，if函数可以包含“else”部分，或是不含。即if函数的参数可以是两个，也可以是三个。
``<condition>`` 参数是if的表达式，如果其返回的为非空字符串，那么这个表达式就相当于返回真，
于是， ``<then-part>`` 会被计算，否则 ``<else-part>`` 会被计算。
而if函数的返回值是，如果 ``<condition>`` 为真（非空字符串），那个 ``<then-part>``
会是整个函数的返回值，如果 ``<condition>`` 为假（空字符串），那么 ``<else-part>`` 会是
整个函数的返回值，此时如果 ``<else-part>`` 没有被定义，那么，整个函数返回空字串。
所以， ``<then-part>`` 和 ``<else-part>`` 只会有一个被计算。
call函数
--------
call函数是唯一一个可以用来创建新的参数化的函数。你可以写一个非常复杂的表达式，这个表达式中，
你可以定义许多参数，然后你可以call函数来向这个表达式传递参数。其语法是：
.. code-block:: makefile
$(call <expression>,<parm1>,<parm2>,...,<parmn>)
当make执行这个函数时， ``<expression>`` 参数中的变量，如 ``$(1)`` 、 ``$(2)`` 等，会
被参数 ``<parm1>`` 、 ``<parm2>`` 、 ``<parm3>`` 依次取代。而 ``<expression>`` 的
返回值就是 call 函数的返回值。例如：
.. code-block:: makefile
reverse = $(1) $(2)
foo = $(call reverse,a,b)
那么， ``foo`` 的值就是 ``a b`` 。当然，参数的次序是可以自定义的，不一定是顺序的，如：
.. code-block:: makefile
reverse = $(2) $(1)
foo = $(call reverse,a,b)
此时的 ``foo`` 的值就是 ``b a`` 。
需要注意：在向 call 函数传递参数时要尤其注意空格的使用。call 函数在处理参数时，第2个及其之后的
参数中的空格会被保留，因而可能造成一些奇怪的效果。因而在向call函数提供参数时，最安全的做法是
去除所有多余的空格。
origin函数
----------
origin函数不像其它的函数，他并不操作变量的值，他只是告诉你你的这个变量是哪里来的？其语法是：
.. code-block:: makefile
$(origin <variable>)
注意， ``<variable>`` 是变量的名字，不应该是引用。所以你最好不要在 ``<variable>`` 中使用
``$`` 字符。Origin函数会以其返回值来告诉你这个变量的“出生情况”，下面，是origin函数的返回值:
``undefined``
如果 ``<variable>`` 从来没有定义过，origin函数返回这个值 ``undefined``
``default``
如果 ``<variable>`` 是一个默认的定义，比如“CC”这个变量，这种变量我们将在后面讲述。
``environment``
如果 ``<variable>`` 是一个环境变量，并且当Makefile被执行时， ``-e`` 参数没有被打开。
``file``
如果 ``<variable>`` 这个变量被定义在Makefile中。
``command line``
如果 ``<variable>`` 这个变量是被命令行定义的。
``override``
如果 ``<variable>`` 是被override指示符重新定义的。
``automatic``
如果 ``<variable>`` 是一个命令运行中的自动化变量。关于自动化变量将在后面讲述。
这些信息对于我们编写Makefile是非常有用的，例如，假设我们有一个Makefile其包了一个定义文件
Make.def，在 Make.def中定义了一个变量“bletch”，而我们的环境中也有一个环境变量“bletch”，
此时，我们想判断一下，如果变量来源于环境，那么我们就把之重定义了，如果来源于Make.def或是命令行
等非环境的，那么我们就不重新定义它。于是，在我们的Makefile中，我们可以这样写：
.. code-block:: makefile
ifdef bletch
ifeq "$(origin bletch)" "environment"
bletch = barf, gag, etc.
endif
endif
当然，你也许会说，使用 ``override`` 关键字不就可以重新定义环境中的变量了吗？为什么需要使用这样
的步骤？是的，我们用 ``override`` 是可以达到这样的效果，可是 ``override`` 过于粗暴，它同时
会把从命令行定义的变量也覆盖了，而我们只想重新定义环境传来的，而不想重新定义命令行传来的。
shell函数
---------
shell函数也不像其它的函数。顾名思义，它的参数应该就是操作系统Shell的命令。它和反引号“`”是
相同的功能。这就是说，shell函数把执行操作系统命令后的输出作为函数返回。于是，我们可以用操作
系统命令以及字符串处理命令awk，sed等等命令来生成一个变量，如：
.. code-block:: makefile
contents := $(shell cat foo)
files := $(shell echo *.c)
注意，这个函数会新生成一个Shell程序来执行命令，所以你要注意其运行性能，如果你的Makefile中
有一些比较复杂的规则，并大量使用了这个函数，那么对于你的系统性能是有害的。特别是Makefile的
隐晦的规则可能会让你的shell函数执行的次数比你想像的多得多。
控制make的函数
--------------
make提供了一些函数来控制make的运行。通常，你需要检测一些运行Makefile时的运行时信息，并且
根据这些信息来决定，你是让make继续执行，还是停止。
.. code-block:: makefile
$(error <text ...>)
产生一个致命的错误， ``<text ...>`` 是错误信息。注意，error函数不会在一被使用就会产生错误
信息，所以如果你把其定义在某个变量中，并在后续的脚本中使用这个变量，那么也是可以的。例如：
示例一：
.. code-block:: makefile
ifdef ERROR_001
$(error error is $(ERROR_001))
endif
示例二：
.. code-block:: makefile
ERR = $(error found an error!)
.PHONY: err
err: $(ERR)
示例一会在变量ERROR_001定义了后执行时产生error调用，而示例二则在目录err被执行时才发生error调用。
.. code-block:: makefile
$(warning <text ...>)
这个函数很像error函数，只是它并不会让make退出，只是输出一段警告信息，而make继续执行。

514
_sources/implicit_rules.rst.txt Normal file
View File

@ -0,0 +1,514 @@
隐含规则
========
在我们使用Makefile时，有一些我们会经常使用，而且使用频率非常高的东西，比如，我们编译C/C++的
源程序为中间目标文件（Unix下是 ``.o`` 文件，Windows下是 ``.obj`` 文件）。本章讲述的就是
一些在Makefile中的“隐含的”，早先约定了的，不需要我们再写出来的规则。
“隐含规则”也就是一种惯例，make会按照这种“惯例”心照不喧地来运行，那怕我们的Makefile中没有书写
这样的规则。例如，把 ``.c`` 文件编译成 ``.o`` 文件这一规则，你根本就不用写出来，make会自动
推导出这种规则，并生成我们需要的 ``.o`` 文件。
“隐含规则”会使用一些我们系统变量，我们可以改变这些系统变量的值来定制隐含规则的运行时的参数。
如系统变量 ``CFLAGS`` 可以控制编译时的编译器参数。
我们还可以通过“模式规则”的方式写下自己的隐含规则。用“后缀规则”来定义隐含规则会有许多的限制。
使用“模式规则”会更回得智能和清楚，但“后缀规则”可以用来保证我们Makefile的兼容性。
我们了解了“隐含规则”，可以让其为我们更好的服务，也会让我们知道一些“约定俗成”了的东西，而不至于
使得我们在运行Makefile时出现一些我们觉得莫名其妙的东西。当然，任何事物都是矛盾的，水能载舟，
亦可覆舟，所以，有时候“隐含规则”也会给我们造成不小的麻烦。只有了解了它，我们才能更好地使用它。
使用隐含规则
------------
如果要使用隐含规则生成你需要的目标，你所需要做的就是不要写出这个目标的规则。那么，make会试图去
自动推导产生这个目标的规则和命令，如果 make可以自动推导生成这个目标的规则和命令，那么这个行为
就是隐含规则的自动推导。当然，隐含规则是make事先约定好的一些东西。例如，我们有下面的一个Makefile：
.. code-block:: makefile
foo : foo.o bar.o
cc –o foo foo.o bar.o $(CFLAGS) $(LDFLAGS)
我们可以注意到，这个Makefile中并没有写下如何生成 ``foo.o`` 和 ``bar.o`` 这两目标的规则和命令。
因为make的“隐含规则”功能会自动为我们自动去推导这两个目标的依赖目标和生成命令。
make会在自己的“隐含规则”库中寻找可以用的规则，如果找到，那么就会使用。如果找不到，那么就会报错。
在上面的那个例子中，make调用的隐含规则是，把 ``.o`` 的目标的依赖文件置成 ``.c`` ，并使用C的
编译命令 ``cc –c $(CFLAGS) foo.c`` 来生成 ``foo.o`` 的目标。也就是说，我们完全没有必要
写下下面的两条规则：
.. code-block:: makefile
foo.o : foo.c
cc –c foo.c $(CFLAGS)
bar.o : bar.c
cc –c bar.c $(CFLAGS)
因为，这已经是“约定”好了的事了，make和我们约定好了用C编译器 ``cc`` 生成 ``.o`` 文件的规则，
这就是隐含规则。
当然，如果我们为 ``.o`` 文件书写了自己的规则，那么make就不会自动推导并调用隐含规则，它会按照
我们写好的规则忠实地执行。
还有，在make的“隐含规则库”中，每一条隐含规则都在库中有其顺序，越靠前的则是越被经常使用的，所以，
这会导致我们有些时候即使我们显示地指定了目标依赖，make也不会管。如下面这条规则（没有命令）：
.. code-block:: makefile
foo.o : foo.p
依赖文件 ``foo.p`` （Pascal程序的源文件）有可能变得没有意义。如果目录下存在了 ``foo.c`` 文件，
那么我们的隐含规则一样会生效，并会通过 ``foo.c`` 调用C的编译器生成 ``foo.o`` 文件。因为，在
隐含规则中，Pascal的规则出现在C的规则之后，所以，make找到可以生成 ``foo.o`` 的C的规则就不再
寻找下一条规则了。如果你确实不希望任何隐含规则推导，那么，你就不要只写出“依赖规则”，而不写命令。
隐含规则一览
------------
这里我们将讲述所有预先设置（也就是make内建）的隐含规则，如果我们不明确地写下规则，那么，make就
会在这些规则中寻找所需要规则和命令。当然，我们也可以使用make的参数 ``-r`` 或 ``--no-builtin-rules``
选项来取消所有的预设置的隐含规则。
当然，即使是我们指定了 ``-r`` 参数，某些隐含规则还是会生效，因为有许多的隐含规则都是使用了
“后缀规则”来定义的，所以，只要隐含规则中有 “后缀列表”（也就一系统定义在目标 ``.SUFFIXES``
的依赖目标），那么隐含规则就会生效。默认的后缀列表是：
.out, .a, .ln, .o, .c, .cc, .C, .p, .f, .F, .r, .y, .l, .s, .S, .mod, .sym,
.def, .h, .info, .dvi, .tex, .texinfo, .texi, .txinfo, .w, .ch .web, .sh, .elc, .el。
具体的细节，我们会在后面讲述。
还是先来看一看常用的隐含规则吧。
#. 编译C程序的隐含规则。
``<n>.o`` 的目标的依赖目标会自动推导为 ``<n>.c`` ，并且其生成命令是 ``$(CC) –c $(CPPFLAGS) $(CFLAGS)``
#. 编译C++程序的隐含规则。
``<n>.o`` 的目标的依赖目标会自动推导为 ``<n>.cc`` 或是 ``<n>.C`` ，并且其生成命令是
``$(CXX) –c $(CPPFLAGS) $(CXXFLAGS)`` 。（建议使用 ``.cc`` 作为C++源文件的后缀，而不是 ``.C`` ）
#. 编译Pascal程序的隐含规则。
``<n>.o`` 的目标的依赖目标会自动推导为 ``<n>.p`` ，并且其生成命令是 ``$(PC) –c $(PFLAGS)`` 。
#. 编译Fortran/Ratfor程序的隐含规则。
``<n>.o`` 的目标的依赖目标会自动推导为 ``<n>.r`` 或 ``<n>.F`` 或 ``<n>.f`` ，并且其生成命令是:
- ``.f`` ``$(FC) –c $(FFLAGS)``
- ``.F`` ``$(FC) –c $(FFLAGS) $(CPPFLAGS)``
- ``.f`` ``$(FC) –c $(FFLAGS) $(RFLAGS)``
#. 预处理Fortran/Ratfor程序的隐含规则。
``<n>.f`` 的目标的依赖目标会自动推导为 ``<n>.r`` 或 ``<n>.F`` 。这个规则只是转换Ratfor
或有预处理的Fortran程序到一个标准的Fortran程序。其使用的命令是：
- ``.F`` ``$(FC) –F $(CPPFLAGS) $(FFLAGS)``
- ``.r`` ``$(FC) –F $(FFLAGS) $(RFLAGS)``
#. 编译Modula-2程序的隐含规则。
``<n>.sym`` 的目标的依赖目标会自动推导为 ``<n>.def`` ，并且其生成命令是：
``$(M2C) $(M2FLAGS) $(DEFFLAGS)`` 。 ``<n>.o`` 的目标的依赖目标会自动推导为 ``<n>.mod`` ，
并且其生成命令是： ``$(M2C) $(M2FLAGS) $(MODFLAGS)`` 。
#. 汇编和汇编预处理的隐含规则。
``<n>.o`` 的目标的依赖目标会自动推导为 ``<n>.s`` ，默认使用编译器 ``as`` ，并且其生成
命令是： ``$ (AS) $(ASFLAGS)`` 。 ``<n>.s`` 的目标的依赖目标会自动推导为 ``<n>.S`` ，
默认使用C预编译器 ``cpp`` ，并且其生成命令是： ``$(AS) $(ASFLAGS)`` 。
#. 链接Object文件的隐含规则。
``<n>`` 目标依赖于 ``<n>.o`` ，通过运行C的编译器来运行链接程序生成（一般是 ``ld`` ），
其生成命令是： ``$(CC) $(LDFLAGS) <n>.o $(LOADLIBES) $(LDLIBS)`` 。这个规则对于
只有一个源文件的工程有效，同时也对多个Object文件（由不同的源文件生成）的也有效。例如如下规则::
x : y.o z.o
并且 ``x.c`` 、 ``y.c`` 和 ``z.c`` 都存在时，隐含规则将执行如下命令::
cc -c x.c -o x.o
cc -c y.c -o y.o
cc -c z.c -o z.o
cc x.o y.o z.o -o x
rm -f x.o
rm -f y.o
rm -f z.o
如果没有一个源文件（如上例中的x.c）和你的目标名字（如上例中的x）相关联，那么，你最好写出自己
的生成规则，不然，隐含规则会报错的。
#. Yacc C程序时的隐含规则。
``<n>.c`` 的依赖文件被自动推导为 ``n.y`` （Yacc生成的文件），其生成命令是： ``$(YACC) $(YFALGS)`` 。
（“Yacc”是一个语法分析器，关于其细节请查看相关资料）
#. Lex C程序时的隐含规则。
``<n>.c`` 的依赖文件被自动推导为 ``n.l`` （Lex生成的文件），其生成命令是： ``$(LEX) $(LFALGS)`` 。
（关于“Lex”的细节请查看相关资料）
#. Lex Ratfor程序时的隐含规则。
``<n>.r`` 的依赖文件被自动推导为 ``n.l`` （Lex生成的文件），其生成命令是： ``$(LEX) $(LFALGS)`` 。
#. 从C程序、Yacc文件或Lex文件创建Lint库的隐含规则。
``<n>.ln`` （lint生成的文件）的依赖文件被自动推导为 ``n.c`` ，其生成命令是：
``$(LINT) $(LINTFALGS) $(CPPFLAGS) -i`` 。对于 ``<n>.y`` 和 ``<n>.l`` 也是同样的规则。
隐含规则使用的变量
------------------
在隐含规则中的命令中，基本上都是使用了一些预先设置的变量。你可以在你的makefile中改变这些变量的值，
或是在make的命令行中传入这些值，或是在你的环境变量中设置这些值，无论怎么样，只要设置了这些特定的变量，
那么其就会对隐含规则起作用。当然，你也可以利用make的 ``-R`` 或 ``--no–builtin-variables``
参数来取消你所定义的变量对隐含规则的作用。
例如，第一条隐含规则——编译C程序的隐含规则的命令是 ``$(CC) –c $(CFLAGS) $(CPPFLAGS)`` 。
Make默认的编译命令是 ``cc`` ，如果你把变量 ``$(CC)`` 重定义成 ``gcc`` ，把变量 ``$(CFLAGS)``
重定义成 ``-g`` ，那么，隐含规则中的命令全部会以 ``gcc –c -g $(CPPFLAGS)`` 的样子来执行了。
我们可以把隐含规则中使用的变量分成两种：一种是命令相关的，如 ``CC`` ；一种是参数相的关，如
``CFLAGS`` 。下面是所有隐含规则中会用到的变量：
关于命令的变量。
~~~~~~~~~~~~~~~~
- ``AR`` : 函数库打包程序。默认命令是 ``ar``
- ``AS`` : 汇编语言编译程序。默认命令是 ``as``
- ``CC`` : C语言编译程序。默认命令是 ``cc``
- ``CXX`` : C++语言编译程序。默认命令是 ``g++``
- ``CO`` : 从 RCS文件中扩展文件程序。默认命令是 ``co``
- ``CPP`` : C程序的预处理器（输出是标准输出设备）。默认命令是 ``$(CC) –E``
- ``FC`` : Fortran 和 Ratfor 的编译器和预处理程序。默认命令是 ``f77``
- ``GET`` : 从SCCS文件中扩展文件的程序。默认命令是 ``get``
- ``LEX`` : Lex方法分析器程序（针对于C或Ratfor）。默认命令是 ``lex``
- ``PC`` : Pascal语言编译程序。默认命令是 ``pc``
- ``YACC`` : Yacc文法分析器（针对于C程序）。默认命令是 ``yacc``
- ``YACCR`` : Yacc文法分析器（针对于Ratfor程序）。默认命令是 ``yacc –r``
- ``MAKEINFO`` : 转换Texinfo源文件（.texi）到Info文件程序。默认命令是 ``makeinfo``
- ``TEX`` : 从TeX源文件创建TeX DVI文件的程序。默认命令是 ``tex``
- ``TEXI2DVI`` : 从Texinfo源文件创建军TeX DVI 文件的程序。默认命令是 ``texi2dvi``
- ``WEAVE`` : 转换Web到TeX的程序。默认命令是 ``weave``
- ``CWEAVE`` : 转换C Web 到 TeX的程序。默认命令是 ``cweave``
- ``TANGLE`` : 转换Web到Pascal语言的程序。默认命令是 ``tangle``
- ``CTANGLE`` : 转换C Web 到 C。默认命令是 ``ctangle``
- ``RM`` : 删除文件命令。默认命令是 ``rm –f``
关于命令参数的变量
~~~~~~~~~~~~~~~~~~
下面的这些变量都是相关上面的命令的参数。如果没有指明其默认值，那么其默认值都是空。
- ``ARFLAGS`` : 函数库打包程序AR命令的参数。默认值是 ``rv``
- ``ASFLAGS`` : 汇编语言编译器参数。（当明显地调用 ``.s`` 或 ``.S`` 文件时）
- ``CFLAGS`` : C语言编译器参数。
- ``CXXFLAGS`` : C++语言编译器参数。
- ``COFLAGS`` : RCS命令参数。
- ``CPPFLAGS`` : C预处理器参数。（ C 和 Fortran 编译器也会用到）。
- ``FFLAGS`` : Fortran语言编译器参数。
- ``GFLAGS`` : SCCS “get”程序参数。
- ``LDFLAGS`` : 链接器参数。（如： ``ld`` ）
- ``LFLAGS`` : Lex文法分析器参数。
- ``PFLAGS`` : Pascal语言编译器参数。
- ``RFLAGS`` : Ratfor 程序的Fortran 编译器参数。
- ``YFLAGS`` : Yacc文法分析器参数。
隐含规则链
----------
有些时候，一个目标可能被一系列的隐含规则所作用。例如，一个 ``.o`` 的文件生成，可能会是先被
Yacc的[.y]文件先成 ``.c`` ，然后再被C的编译器生成。我们把这一系列的隐含规则叫做“隐含规则链”。
在上面的例子中，如果文件 ``.c`` 存在，那么就直接调用C的编译器的隐含规则，如果没有 ``.c`` 文件，
但有一个 ``.y`` 文件，那么Yacc的隐含规则会被调用，生成 ``.c`` 文件，然后，再调用C编译的隐含
规则最终由 ``.c`` 生成 ``.o`` 文件，达到目标。
我们把这种 ``.c`` 的文件（或是目标），叫做中间目标。不管怎么样，make会努力自动推导生成目标的
一切方法，不管中间目标有多少，其都会执着地把所有的隐含规则和你书写的规则全部合起来分析，努力达到
目标，所以，有些时候，可能会让你觉得奇怪，怎么我的目标会这样生成？怎么我的 makefile发疯了？
在默认情况下，对于中间目标，它和一般的目标有两个地方所不同：第一个不同是除非中间的目标不存在，
才会引发中间规则。第二个不同的是，只要目标成功产生，那么，产生最终目标过程中，所产生的中间目标
文件会被以 ``rm -f`` 删除。
通常，一个被makefile指定成目标或是依赖目标的文件不能被当作中介。然而，你可以明显地说明一个
文件或是目标是中介目标，你可以使用伪目标 ``.INTERMEDIATE`` 来强制声明。
（如： ``.INTERMEDIATE : mid`` ）
你也可以阻止make自动删除中间目标，要做到这一点，你可以使用伪目标 ``.SECONDARY`` 来强制声明
（如： ``.SECONDARY : sec`` ）。你还可以把你的目标，以模式的方式来指定（如： ``%.o`` ）成
伪目标 ``.PRECIOUS`` 的依赖目标，以保存被隐含规则所生成的中间文件。
在“隐含规则链”中，禁止同一个目标出现两次或两次以上，这样一来，就可防止在make自动推导时出现
无限递归的情况。
Make会优化一些特殊的隐含规则，而不生成中间文件。如，从文件 ``foo.c`` 生成目标程序 ``foo`` ，
按道理，make会编译生成中间文件 ``foo.o`` ，然后链接成 ``foo`` ，但在实际情况下，这一动作可以
被一条 ``cc`` 的命令完成（ ``cc –o foo foo.c`` ），于是优化过的规则就不会生成中间文件。
定义模式规则
------------
你可以使用模式规则来定义一个隐含规则。一个模式规则就好像一个一般的规则，只是在规则中，目标的定义
需要有 ``%`` 字符。 ``%`` 的意思是表示一个或多个任意字符。在依赖目标中同样可以使用 ``%`` ，
只是依赖目标中的 ``%`` 的取值，取决于其目标。
有一点需要注意的是， ``%`` 的展开发生在变量和函数的展开之后，变量和函数的展开发生在make载入
Makefile时，而模式规则中的 ``%`` 则发生在运行时。
模式规则介绍
~~~~~~~~~~~~
模式规则中，至少在规则的目标定义中要包含 ``%`` ，否则，就是一般的规则。目标中的 ``%`` 定义
表示对文件名的匹配， ``%`` 表示长度任意的非空字符串。例如： ``%.c`` 表示以 ``.c`` 结尾的
文件名（文件名的长度至少为3），而 ``s.%.c`` 则表示以 ``s.`` 开头， ``.c`` 结尾的文件名
（文件名的长度至少为5）。
如果 ``%`` 定义在目标中，那么，目标中的 ``%`` 的值决定了依赖目标中的 ``%`` 的值，也就是说，
目标中的模式的 ``%`` 决定了依赖目标中 ``%`` 的样子。例如有一个模式规则如下：
.. code-block:: makefile
%.o : %.c ; <command ......>;
其含义是，指出了怎么从所有的 ``.c`` 文件生成相应的 ``.o`` 文件的规则。如果要生成的目标是
``a.o b.o`` ，那么 ``%c`` 就是 ``a.c b.c`` 。
一旦依赖目标中的 ``%`` 模式被确定，那么，make会被要求去匹配当前目录下所有的文件名，一旦找到，
make就会规则下的命令，所以，在模式规则中，目标可能会是多个的，如果有模式匹配出多个目标，make就
会产生所有的模式目标，此时，make关心的是依赖的文件名和生成目标的命令这两件事。
模式规则示例
~~~~~~~~~~~~
下面这个例子表示了,把所有的 ``.c`` 文件都编译成 ``.o`` 文件.
.. code-block:: makefile
%.o : %.c
$(CC) -c $(CFLAGS) $(CPPFLAGS) $< -o $@
其中， ``$@`` 表示所有的目标的挨个值， ``$<`` 表示了所有依赖目标的挨个值。这些奇怪的变量我们
叫“自动化变量”，后面会详细讲述。
下面的这个例子中有两个目标是模式的：
.. code-block:: makefile
%.tab.c %.tab.h: %.y
bison -d $<
这条规则告诉make把所有的 ``.y`` 文件都以 ``bison -d <n>.y`` 执行，然后生成 ``<n>.tab.c``
和 ``<n>.tab.h`` 文件。（其中， ``<n>`` 表示一个任意字符串）。如果我们的执行程序 ``foo``
依赖于文件 ``parse.tab.o`` 和 ``scan.o`` ，并且文件 ``scan.o`` 依赖于文件 ``parse.tab.h`` ，
如果 ``parse.y`` 文件被更新了，那么根据上述的规则， ``bison -d parse.y`` 就会被执行一次，
于是， ``parse.tab.o`` 和 ``scan.o`` 的依赖文件就齐了。（假设， ``parse.tab.o`` 由
``parse.tab.c`` 生成，和 ``scan.o`` 由 ``scan.c`` 生成，而 ``foo`` 由 ``parse.tab.o``
和 ``scan.o`` 链接生成，而且 ``foo`` 和其 ``.o`` 文件的依赖关系也写好，那么，所有的目标都会得到满足）
自动化变量
~~~~~~~~~~
在上述的模式规则中，目标和依赖文件都是一系例的文件，那么我们如何书写一个命令来完成从不同的依赖
文件生成相应的目标？因为在每一次的对模式规则的解析时，都会是不同的目标和依赖文件。
自动化变量就是完成这个功能的。在前面，我们已经对自动化变量有所提涉，相信你看到这里已对它有一个
感性认识了。所谓自动化变量，就是这种变量会把模式中所定义的一系列的文件自动地挨个取出，直至所有的
符合模式的文件都取完了。这种自动化变量只应出现在规则的命令中。
下面是所有的自动化变量及其说明：
- ``$@`` : 表示规则中的目标文件集。在模式规则中，如果有多个目标，那么， ``$@`` 就是匹配于
目标中模式定义的集合。
- ``$%`` : 仅当目标是函数库文件中，表示规则中的目标成员名。例如，如果一个目标是 ``foo.a(bar.o)`` ，
那么， ``$%`` 就是 ``bar.o`` ， ``$@`` 就是 ``foo.a`` 。如果目标不是函数库文件
（Unix下是 ``.a`` ，Windows下是 ``.lib`` ），那么，其值为空。
- ``$<`` : 依赖目标中的第一个目标名字。如果依赖目标是以模式（即 ``%`` ）定义的，那么 ``$<``
将是符合模式的一系列的文件集。注意，其是一个一个取出来的。
- ``$?`` : 所有比目标新的依赖目标的集合。以空格分隔。
- ``$^`` : 所有的依赖目标的集合。以空格分隔。如果在依赖目标中有多个重复的，那么这个变量会去除
重复的依赖目标，只保留一份。
- ``$+`` : 这个变量很像 ``$^`` ，也是所有依赖目标的集合。只是它不去除重复的依赖目标。
- ``$*`` : 这个变量表示目标模式中 ``%`` 及其之前的部分。如果目标是 ``dir/a.foo.b`` ，并且
目标的模式是 ``a.%.b`` ，那么， ``$*`` 的值就是 ``dir/foo`` 。这个变量对于构造有关联的
文件名是比较有效。如果目标中没有模式的定义，那么 ``$*`` 也就不能被推导出，但是，如果目标文件的
后缀是make所识别的，那么 ``$*`` 就是除了后缀的那一部分。例如：如果目标是 ``foo.c`` ，因为
``.c`` 是make所能识别的后缀名，所以， ``$*`` 的值就是 ``foo`` 。这个特性是GNU make的，
很有可能不兼容于其它版本的make，所以，你应该尽量避免使用 ``$*`` ，除非是在隐含规则或是静态
模式中。如果目标中的后缀是make所不能识别的，那么 ``$*`` 就是空值。
当你希望只对更新过的依赖文件进行操作时， ``$?`` 在显式规则中很有用，例如，假设有一个函数库文件
叫 ``lib`` ，其由其它几个object文件更新。那么把object文件打包的比较有效率的Makefile规则是：
.. code-block:: makefile
lib : foo.o bar.o lose.o win.o
ar r lib $?
在上述所列出来的自动量变量中。四个变量（ ``$@`` 、 ``$<`` 、 ``$%`` 、 ``$*`` ）在扩展时
只会有一个文件，而另三个的值是一个文件列表。这七个自动化变量还可以取得文件的目录名或是在当前
目录下的符合模式的文件名，只需要搭配上 ``D`` 或 ``F`` 字样。这是GNU make中老版本的特性，
在新版本中，我们使用函数 ``dir`` 或 ``notdir`` 就可以做到了。 ``D`` 的含义就是Directory，
就是目录， ``F`` 的含义就是File，就是文件。
下面是对于上面的七个变量分别加上 ``D`` 或是 ``F`` 的含义：
``$(@D)``
表示 ``$@`` 的目录部分（不以斜杠作为结尾），如果 ``$@`` 值是 ``dir/foo.o`` ，那么
``$(@D)`` 就是 ``dir`` ，而如果 ``$@`` 中没有包含斜杠的话，其值就是 ``.`` （当前目录）。
``$(@F)``
表示 ``$@`` 的文件部分，如果 ``$@`` 值是 ``dir/foo.o`` ，那么 ``$(@F)`` 就是 ``foo.o`` ，
``$(@F)`` 相当于函数 ``$(notdir $@)`` 。
``$(*D)``, ``$(*F)``
和上面所述的同理，也是取文件的目录部分和文件部分。对于上面的那个例子， ``$(*D)`` 返回 ``dir`` ，
而 ``$(*F)`` 返回 ``foo``
``$(%D)``, ``$(%F)``
分别表示了函数包文件成员的目录部分和文件部分。这对于形同 ``archive(member)`` 形式的目标中的
``member`` 中包含了不同的目录很有用。
``$(<D)``, ``$(<F)``
分别表示依赖文件的目录部分和文件部分。
``$(^D)``, ``$(^F)``
分别表示所有依赖文件的目录部分和文件部分。（无相同的）
``$(+D)``, ``$(+F)``
分别表示所有依赖文件的目录部分和文件部分。（可以有相同的）
``$(?D)``, ``$(?F)``
分别表示被更新的依赖文件的目录部分和文件部分。
最后想提醒一下的是，对于 ``$<`` ，为了避免产生不必要的麻烦，我们最好给 ``$`` 后面的那个特定
字符都加上圆括号，比如， ``$(<)`` 就要比 ``$<`` 要好一些。
还得要注意的是，这些变量只使用在规则的命令中，而且一般都是“显式规则”和“静态模式规则”
（参见前面“书写规则”一章）。其在隐含规则中并没有意义。
模式的匹配
~~~~~~~~~~
一般来说，一个目标的模式有一个有前缀或是后缀的 ``%`` ，或是没有前后缀，直接就是一个 ``%`` 。
因为 ``%`` 代表一个或多个字符，所以在定义好了的模式中，我们把 ``%`` 所匹配的内容叫做“茎”，例如
``%.c`` 所匹配的文件“test.c”中“test”就是“茎”。因为在目标和依赖目标中同时有 ``%`` 时，依赖
目标的“茎”会传给目标，当做目标中的“茎”。
当一个模式匹配包含有斜杠（实际也不经常包含）的文件时，那么在进行模式匹配时，目录部分会首先被移开，
然后进行匹配，成功后，再把目录加回去。在进行“茎”的传递时，我们需要知道这个步骤。例如有一个模式
``e%t`` ，文件 ``src/eat`` 匹配于该模式，于是 ``src/a`` 就是其“茎”，如果这个模式定义在依赖
目标中，而被依赖于这个模式的目标中又有个模式 ``c%r`` ，那么，目标就是 ``src/car`` 。（“茎”被传递）
重载内建隐含规则
~~~~~~~~~~~~~~~~
你可以重载内建的隐含规则（或是定义一个全新的），例如你可以重新构造和内建隐含规则不同的命令，如：
.. code-block:: makefile
%.o : %.c
$(CC) -c $(CPPFLAGS) $(CFLAGS) -D$(date)
你可以取消内建的隐含规则，只要不在后面写命令就行。如：
.. code-block:: makefile
%.o : %.s
同样，你也可以重新定义一个全新的隐含规则，其在隐含规则中的位置取决于你在哪里写下这个规则。朝前的
位置就靠前。
老式风格的“后缀规则”
--------------------
后缀规则是一个比较老式的定义隐含规则的方法。后缀规则会被模式规则逐步地取代。因为模式规则更强更清晰。
为了和老版本的Makefile兼容，GNU make同样兼容于这些东西。后缀规则有两种方式：“双后缀”和“单后缀”。
双后缀规则定义了一对后缀：目标文件的后缀和依赖目标（源文件）的后缀。如 ``.c.o`` 相当于 ``%o : %c`` 。
单后缀规则只定义一个后缀，也就是源文件的后缀。如 ``.c`` 相当于 ``% : %.c`` 。
后缀规则中所定义的后缀应该是make所认识的，如果一个后缀是make所认识的，那么这个规则就是单后缀规则，
而如果两个连在一起的后缀都被make所认识，那就是双后缀规则。例如： ``.c`` 和 ``.o`` 都是make所知道。
因而，如果你定义了一个规则是 ``.c.o`` 那么其就是双后缀规则，意义就是 ``.c`` 是源文件的后缀， ``.o``
是目标文件的后缀。如下示例：
.. code-block:: makefile
.c.o:
$(CC) -c $(CFLAGS) $(CPPFLAGS) -o $@ $<
后缀规则不允许任何的依赖文件，如果有依赖文件的话，那就不是后缀规则，那些后缀统统被认为是文件名，如：
.. code-block:: makefile
.c.o: foo.h
$(CC) -c $(CFLAGS) $(CPPFLAGS) -o $@ $<
这个例子，就是说，文件 ``.c.o`` 依赖于文件 ``foo.h`` ，而不是我们想要的这样：
.. code-block:: makefile
%.o: %.c foo.h
$(CC) -c $(CFLAGS) $(CPPFLAGS) -o $@ $<
后缀规则中，如果没有命令，那是毫无意义的。因为他也不会移去内建的隐含规则。
而要让make知道一些特定的后缀，我们可以使用伪目标 ``.SUFFIXES`` 来定义或是删除，如：
.. code-block:: makefile
.SUFFIXES: .hack .win
把后缀 ``.hack`` 和 ``.win`` 加入后缀列表中的末尾。
.. code-block:: makefile
.SUFFIXES: # 删除默认的后缀
.SUFFIXES: .c .o .h # 定义自己的后缀
先清除默认后缀，后定义自己的后缀列表。
make的参数 ``-r`` 或 ``-no-builtin-rules`` 也会使用得默认的后缀列表为空。而变量
``SUFFIXE`` 被用来定义默认的后缀列表，你可以用 ``.SUFFIXES`` 来改变后缀列表，但请不要
改变变量 ``SUFFIXE`` 的值。
隐含规则搜索算法
----------------
比如我们有一个目标叫 T。下面是搜索目标T的规则的算法。请注意，在下面，我们没有提到后缀规则，
原因是，所有的后缀规则在Makefile被载入内存时，会被转换成模式规则。如果目标是 ``archive(member)``
的函数库文件模式，那么这个算法会被运行两次，第一次是找目标T，如果没有找到的话，那么进入第二次，
第二次会把 ``member`` 当作T来搜索。
#. 把T的目录部分分离出来。叫D，而剩余部分叫N。（如：如果T是 ``src/foo.o`` ，那么，D就是
``src/`` ，N就是 ``foo.o`` ）
#. 创建所有匹配于T或是N的模式规则列表。
#. 如果在模式规则列表中有匹配所有文件的模式，如 ``%`` ，那么从列表中移除其它的模式。
#. 移除列表中没有命令的规则。
#. 对于第一个在列表中的模式规则：
#. 推导其“茎”S，S应该是T或是N匹配于模式中 ``%`` 非空的部分。
#. 计算依赖文件。把依赖文件中的 ``%`` 都替换成“茎”S。如果目标模式中没有包含斜框字符，
而把D加在第一个依赖文件的开头。
#. 测试是否所有的依赖文件都存在或是理当存在。（如果有一个文件被定义成另外一个规则的目标文件，
或者是一个显式规则的依赖文件，那么这个文件就叫“理当存在”）
#. 如果所有的依赖文件存在或是理当存在，或是就没有依赖文件。那么这条规则将被采用，退出该算法。
#. 如果经过第5步，没有模式规则被找到，那么就做更进一步的搜索。对于存在于列表中的第一个模式规则：
#. 如果规则是终止规则，那就忽略它，继续下一条模式规则。
#. 计算依赖文件。（同第5步）
#. 测试所有的依赖文件是否存在或是理当存在。
#. 对于不存在的依赖文件，递归调用这个算法查找他是否可以被隐含规则找到。
#. 如果所有的依赖文件存在或是理当存在，或是就根本没有依赖文件。那么这条规则被采用，退出该算法。
#. 如果没有隐含规则可以使用，查看 ``.DEFAULT`` 规则，如果有，采用，把 ``.DEFAULT`` 的命令给T使用。
一旦规则被找到，就会执行其相当的命令，而此时，我们的自动化变量的值才会生成。

20
_sources/index.rst.txt Normal file
View File

@ -0,0 +1,20 @@
跟我一起写Makefile
==================
**本文中可能存在很多 typo 和小错误，欢迎 PR。**
.. toctree::
:maxdepth: 3
:caption: 目录
overview
introduction
rules
recipes
variables
conditionals
functions
invoke
implicit_rules
archives
postscript

395
_sources/introduction.rst.txt Normal file
View File

@ -0,0 +1,395 @@
makefile介绍
============
make命令执行时，需要一个makefile文件，以告诉make命令需要怎么样的去编译和链接程序。
首先，我们用一个示例来说明makefile的书写规则，以便给大家一个感性认识。这个示例来源于gnu
的make使用手册，在这个示例中，我们的工程有8个c文件，和3个头文件，我们要写一个makefile来告
诉make命令如何编译和链接这几个文件。我们的规则是：
#. 如果这个工程没有编译过，那么我们的所有c文件都要编译并被链接。
#. 如果这个工程的某几个c文件被修改，那么我们只编译被修改的c文件，并链接目标程序。
#. 如果这个工程的头文件被改变了，那么我们需要编译引用了这几个头文件的c文件，并链接目标程序。
只要我们的makefile写得够好，所有的这一切，我们只用一个make命令就可以完成，make命令会自动智能
地根据当前的文件修改的情况来确定哪些文件需要重编译，从而自动编译所需要的文件和链接目标程序。
makefile的规则
--------------
在讲述这个makefile之前，还是让我们先来粗略地看一看makefile的规则。
.. code-block:: makefile
target ... : prerequisites ...
command
...
...
target
可以是一个object file（目标文件），也可以是一个执行文件，还可以是一个标签（label）。对
于标签这种特性，在后续的“伪目标”章节中会有叙述。
prerequisites
生成该target所依赖的文件和/或target
command
该target要执行的命令（任意的shell命令）
这是一个文件的依赖关系，也就是说，target这一个或多个的目标文件依赖于prerequisites中的文件，
其生成规则定义在command中。说白一点就是说::
prerequisites中如果有一个以上的文件比target文件要新的话，command所定义的命令就会被执行。
这就是makefile的规则，也就是makefile中最核心的内容。
说到底，makefile的东西就是这样一点，好像我的这篇文档也该结束了。呵呵。还不尽然，这是makefile
的主线和核心，但要写好一个makefile还不够，我会在后面一点一点地结合我的工作经验给你慢慢道来。内
容还多着呢。:)
一个示例
--------
正如前面所说，如果一个工程有3个头文件和8个c文件，为了完成前面所述的那三个规则，我们的makefile
应该是下面的这个样子的。
.. code-block:: makefile
edit : main.o kbd.o command.o display.o \
insert.o search.o files.o utils.o
cc -o edit main.o kbd.o command.o display.o \
insert.o search.o files.o utils.o
main.o : main.c defs.h
cc -c main.c
kbd.o : kbd.c defs.h command.h
cc -c kbd.c
command.o : command.c defs.h command.h
cc -c command.c
display.o : display.c defs.h buffer.h
cc -c display.c
insert.o : insert.c defs.h buffer.h
cc -c insert.c
search.o : search.c defs.h buffer.h
cc -c search.c
files.o : files.c defs.h buffer.h command.h
cc -c files.c
utils.o : utils.c defs.h
cc -c utils.c
clean :
rm edit main.o kbd.o command.o display.o \
insert.o search.o files.o utils.o
反斜杠（ ``\`` ）是换行符的意思。这样比较便于makefile的阅读。我们可以把这个内容保存在名字
为“makefile”或“Makefile”的文件中，然后在该目录下直接输入命令 ``make`` 就可以生成执行文
件edit。如果要删除执行文件和所有的中间目标文件，那么，只要简单地执行一下 ``make clean`` 就
可以了。
在这个makefile中，目标文件（target）包含：执行文件edit和中间目标文件（ ``*.o`` ），依赖文
件（prerequisites）就是冒号后面的那些 ``.c`` 文件和 ``.h`` 文件。每一个 ``.o`` 文件都有
一组依赖文件，而这些 ``.o`` 文件又是执行文件 ``edit`` 的依赖文件。依赖关系的实质就是说明了目
标文件是由哪些文件生成的，换言之，目标文件是哪些文件更新的。
在定义好依赖关系后，后续的那一行定义了如何生成目标文件的操作系统命令，一定要以一个 ``Tab`` 键
作为开头。记住，make并不管命令是怎么工作的，他只管执行所定义的命令。make会比较targets文件
和prerequisites文件的修改日期，如果prerequisites文件的日期要比targets文件的日期要新，或
者target不存在的话，那么，make就会执行后续定义的命令。
这里要说明一点的是， ``clean`` 不是一个文件，它只不过是一个动作名字，有点像c语言中的label一
样，其冒号后什么也没有，那么，make就不会自动去找它的依赖性，也就不会自动执行其后所定义的命令。
要执行其后的命令，就要在make命令后明显得指出这个label的名字。这样的方法非常有用，我们可以在一
个makefile中定义不用的编译或是和编译无关的命令，比如程序的打包，程序的备份，等等。
make是如何工作的
----------------
在默认的方式下，也就是我们只输入 ``make`` 命令。那么，
#. make会在当前目录下找名字叫“Makefile”或“makefile”的文件。
#. 如果找到，它会找文件中的第一个目标文件（target），在上面的例子中，他会找到“edit”这个
文件，并把这个文件作为最终的目标文件。
#. 如果edit文件不存在，或是edit所依赖的后面的 ``.o`` 文件的文件修改时间要比 ``edit`` 这个
文件新，那么，他就会执行后面所定义的命令来生成 ``edit`` 这个文件。
#. 如果 ``edit`` 所依赖的 ``.o`` 文件也不存在，那么make会在当前文件中找目标为 ``.o`` 文件
的依赖性，如果找到则再根据那一个规则生成 ``.o`` 文件。（这有点像一个堆栈的过程）
#. 当然，你的C文件和H文件是存在的啦，于是make会生成 ``.o`` 文件，然后再用 ``.o`` 文件生
成make的终极任务，也就是执行文件 ``edit`` 了。
这就是整个make的依赖性，make会一层又一层地去找文件的依赖关系，直到最终编译出第一个目标文件。在
找寻的过程中，如果出现错误，比如最后被依赖的文件找不到，那么make就会直接退出，并报错，而对于所
定义的命令的错误，或是编译不成功，make根本不理。make只管文件的依赖性，即，如果在我找了依赖关系
之后，冒号后面的文件还是不在，那么对不起，我就不工作啦。
通过上述分析，我们知道，像clean这种，没有被第一个目标文件直接或间接关联，那么它后面所定义的命
令将不会被自动执行，不过，我们可以显示要make执行。即命令—— ``make clean`` ，以此来清除所有
的目标文件，以便重编译。
于是在我们编程中，如果这个工程已被编译过了，当我们修改了其中一个源文件，比如 ``file.c`` ，
那么根据我们的依赖性，我们的目标 ``file.o`` 会被重编译（也就是在这个依性关系后面所定义的命令），
于是 ``file.o`` 的文件也是最新的啦，于是 ``file.o`` 的文件修改时间要比 ``edit`` 要新，所
以 ``edit`` 也会被重新链接了（详见 ``edit`` 目标文件后定义的命令）。
而如果我们改变了 ``command.h`` ，那么， ``kdb.o`` 、 ``command.o`` 和 ``files.o`` 都
会被重编译，并且， ``edit`` 会被重链接。
makefile中使用变量
------------------
在上面的例子中，先让我们看看edit的规则：
.. code-block:: makefile
edit : main.o kbd.o command.o display.o \
insert.o search.o files.o utils.o
cc -o edit main.o kbd.o command.o display.o \
insert.o search.o files.o utils.o
我们可以看到 ``.o`` 文件的字符串被重复了两次，如果我们的工程需要加入一个新的 ``.o`` 文件，
那么我们需要在两个地方加（应该是三个地方，还有一个地方在clean中）。当然，我们的makefile并不复
杂，所以在两个地方加也不累，但如果makefile变得复杂，那么我们就有可能会忘掉一个需要加入的地方，
而导致编译失败。所以，为了makefile的易维护，在makefile中我们可以使用变量。makefile的变量也
就是一个字符串，理解成C语言中的宏可能会更好。
比如，我们声明一个变量，叫 ``objects`` ， ``OBJECTS`` ， ``objs`` ， ``OBJS`` ，
``obj`` 或是 ``OBJ`` ，反正不管什么啦，只要能够表示obj文件就行了。我们在makefile一开始就
这样定义：
.. code-block:: makefile
objects = main.o kbd.o command.o display.o \
insert.o search.o files.o utils.o
于是，我们就可以很方便地在我们的makefile中以 ``$(objects)`` 的方式来使用这个变量了，于是
我们的改良版makefile就变成下面这个样子：
.. code-block:: makefile
objects = main.o kbd.o command.o display.o \
insert.o search.o files.o utils.o
edit : $(objects)
cc -o edit $(objects)
main.o : main.c defs.h
cc -c main.c
kbd.o : kbd.c defs.h command.h
cc -c kbd.c
command.o : command.c defs.h command.h
cc -c command.c
display.o : display.c defs.h buffer.h
cc -c display.c
insert.o : insert.c defs.h buffer.h
cc -c insert.c
search.o : search.c defs.h buffer.h
cc -c search.c
files.o : files.c defs.h buffer.h command.h
cc -c files.c
utils.o : utils.c defs.h
cc -c utils.c
clean :
rm edit $(objects)
于是如果有新的 ``.o`` 文件加入，我们只需简单地修改一下 ``objects`` 变量就可以了。
关于变量更多的话题，我会在后续给你一一道来。
让make自动推导
--------------
GNU的make很强大，它可以自动推导文件以及文件依赖关系后面的命令，于是我们就没必要去在每一个
``.o`` 文件后都写上类似的命令，因为，我们的make会自动识别，并自己推导命令。
只要make看到一个 ``.o`` 文件，它就会自动的把 ``.c`` 文件加在依赖关系中，如果make找到一个
``whatever.o`` ，那么 ``whatever.c`` 就会是 ``whatever.o`` 的依赖文件。并且
``cc -c whatever.c`` 也会被推导出来，于是，我们的makefile再也不用写得这么复杂。我们的
新makefile又出炉了。
.. code-block:: makefile
objects = main.o kbd.o command.o display.o \
insert.o search.o files.o utils.o
edit : $(objects)
cc -o edit $(objects)
main.o : defs.h
kbd.o : defs.h command.h
command.o : defs.h command.h
display.o : defs.h buffer.h
insert.o : defs.h buffer.h
search.o : defs.h buffer.h
files.o : defs.h buffer.h command.h
utils.o : defs.h
.PHONY : clean
clean :
rm edit $(objects)
这种方法，也就是make的“隐晦规则”。上面文件内容中， ``.PHONY`` 表示 ``clean`` 是个伪目标
文件。
关于更为详细的“隐晦规则”和“伪目标文件”，我会在后续给你一一道来。
另类风格的makefiles
-------------------
既然我们的make可以自动推导命令，那么我看到那堆 ``.o`` 和 ``.h`` 的依赖就有点不爽，那么多的
重复的 ``.h`` ，能不能把其收拢起来，好吧，没有问题，这个对于make来说很容易，谁叫它提供了自动
推导命令和文件的功能呢？来看看最新风格的makefile吧。
.. code-block:: 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
.PHONY : clean
clean :
rm edit $(objects)
这种风格，让我们的makefile变得很简单，但我们的文件依赖关系就显得有点凌乱了。鱼和熊掌不可兼得。
还看你的喜好了。我是不喜欢这种风格的，一是文件的依赖关系看不清楚，二是如果文件一多，要加入几个
新的 ``.o`` 文件，那就理不清楚了。
清空目标文件的规则
------------------
每个Makefile中都应该写一个清空目标文件（ ``.o`` 和执行文件）的规则，这不仅便于重编译，也很
利于保持文件的清洁。这是一个“修养”（呵呵，还记得我的《编程修养》吗）。一般的风格都是：
.. code-block:: makefile
clean:
rm edit $(objects)
更为稳健的做法是：
.. code-block:: makefile
.PHONY : clean
clean :
-rm edit $(objects)
前面说过， ``.PHONY`` 表示 ``clean`` 是一个“伪目标”。而在 ``rm`` 命令前面加了一个小减号的
意思就是，也许某些文件出现问题，但不要管，继续做后面的事。当然， ``clean`` 的规则不要放在文件
的开头，不然，这就会变成make的默认目标，相信谁也不愿意这样。不成文的规矩是——“clean从来都是放
在文件的最后”。
上面就是一个makefile的概貌，也是makefile的基础，下面还有很多makefile的相关细节，准备好了
吗？准备好了就来。
Makefile里有什么？
------------------
Makefile里主要包含了五个东西：显式规则、隐晦规则、变量定义、文件指示和注释。
#. 显式规则。显式规则说明了如何生成一个或多个目标文件。这是由Makefile的书写者明显指出要生成的
文件、文件的依赖文件和生成的命令。
#. 隐晦规则。由于我们的make有自动推导的功能，所以隐晦的规则可以让我们比较简略地书写
Makefile，这是由make所支持的。
#. 变量的定义。在Makefile中我们要定义一系列的变量，变量一般都是字符串，这个有点像你C语言中的
宏，当Makefile被执行时，其中的变量都会被扩展到相应的引用位置上。
#. 文件指示。其包括了三个部分，一个是在一个Makefile中引用另一个Makefile，就像C语言中
的include一样；另一个是指根据某些情况指定Makefile中的有效部分，就像C语言中的预编译#if一
样；还有就是定义一个多行的命令。有关这一部分的内容，我会在后续的部分中讲述。
#. 注释。Makefile中只有行注释，和UNIX的Shell脚本一样，其注释是用 ``#`` 字符，这个就
像C/C++中的 ``//`` 一样。如果你要在你的Makefile中使用 ``#`` 字符，可以用反斜杠进行
转义，如： ``\#`` 。
最后，还值得一提的是，在Makefile中的命令，必须要以 ``Tab`` 键开始。
Makefile的文件名
----------------
默认的情况下，make命令会在当前目录下按顺序找寻文件名为“GNUmakefile”、
“makefile”、“Makefile”的文件，找到了解释这个文件。在这三个文件名中，最好使用“Makefile”
这个文件名，因为，这个文件名第一个字符为大写，这样有一种显目的感觉。最好不要用“GNUmakefile”，
这个文件是GNU的make识别的。有另外一些make只对全小写的“makefile”文件名敏感，但是基本上来说，
大多数的make都支持“makefile”和“Makefile”这两种默认文件名。
当然，你可以使用别的文件名来书写Makefile，比如：“Make.Linux”，“Make.Solaris”
，“Make.AIX”等，如果要指定特定的Makefile，你可以使用make的 ``-f`` 和 ``--file`` 参数，
如： ``make -f Make.Linux`` 或 ``make --file Make.AIX`` 。
引用其它的Makefile
------------------
在Makefile使用 ``include`` 关键字可以把别的Makefile包含进来，这很像C语言的
``#include`` ，被包含的文件会原模原样的放在当前文件的包含位置。 ``include`` 的语法是：
.. code-block:: makefile
include <filename>
``filename`` 可以是当前操作系统Shell的文件模式（可以包含路径和通配符）。
在 ``include`` 前面可以有一些空字符，但是绝不能是 ``Tab`` 键开始。 ``include`` 和
``<filename>`` 可以用一个或多个空格隔开。举个例子，你有这样几个Makefile： ``a.mk`` 、
``b.mk`` 、 ``c.mk`` ，还有一个文件叫 ``foo.make`` ，以及一个变量 ``$(bar)`` ，其包含
了 ``e.mk`` 和 ``f.mk`` ，那么，下面的语句：
.. code-block:: makefile
include foo.make *.mk $(bar)
等价于：
.. code-block:: makefile
include foo.make a.mk b.mk c.mk e.mk f.mk
make命令开始时，会找寻 ``include`` 所指出的其它Makefile，并把其内容安置在当前的位置。就好
像C/C++的 ``#include`` 指令一样。如果文件都没有指定绝对路径或是相对路径的话，make会在当前目
录下首先寻找，如果当前目录下没有找到，那么，make还会在下面的几个目录下找：
#. 如果make执行时，有 ``-I`` 或 ``--include-dir`` 参数，那么make就会在这个参数所指定的目
录下去寻找。
#. 如果目录 ``<prefix>/include`` （一般是： ``/usr/local/bin`` 或
``/usr/include`` ）存在的话，make也会去找。
如果有文件没有找到的话，make会生成一条警告信息，但不会马上出现致命错误。它会继续载入其它的
文件，一旦完成makefile的读取，make会再重试这些没有找到，或是不能读取的文件，如果还是
不行，make才会出现一条致命信息。如果你想让make不理那些无法读取的文件，而继续执行，你可以
在include前加一个减号“-”。如：
.. code-block:: makefile
-include <filename>
其表示，无论include过程中出现什么错误，都不要报错继续执行。和其它版本make兼容的相关命令
是sinclude，其作用和这一个是一样的。
环境变量MAKEFILES
-----------------
如果你的当前环境中定义了环境变量 ``MAKEFILES`` ，那么，make会把这个变量中的值做一个类似于
``include`` 的动作。这个变量中的值是其它的Makefile，用空格分隔。只是，它和 ``include`` 不
同的是，从这个环境变量中引入的Makefile的“目标”不会起作用，如果环境变量中定义的文件发现
错误，make也会不理。
但是在这里我还是建议不要使用这个环境变量，因为只要这个变量一被定义，那么当你使用make时，
所有的Makefile都会受到它的影响，这绝不是你想看到的。在这里提这个事，只是为了告诉大家，也许
有时候你的Makefile出现了怪事，那么你可以看看当前环境中有没有定义这个变量。
make的工作方式
--------------
GNU的make工作时的执行步骤如下：（想来其它的make也是类似）
#. 读入所有的Makefile。
#. 读入被include的其它Makefile。
#. 初始化文件中的变量。
#. 推导隐晦规则，并分析所有规则。
#. 为所有的目标文件创建依赖关系链。
#. 根据依赖关系，决定哪些目标要重新生成。
#. 执行生成命令。
1-5步为第一个阶段，6-7为第二个阶段。第一个阶段中，如果定义的变量被使用了，那么，make会把其展
开在使用的位置。但make并不会完全马上展开，make使用的是拖延战术，如果变量出现在依赖关系的规则
中，那么仅当这条依赖被决定要使用了，变量才会在其内部展开。
当然，这个工作方式你不一定要清楚，但是知道这个方式你也会对make更为熟悉。有了这个基础，后续部分
也就容易看懂了。

225
_sources/invoke.rst.txt Normal file
View File

@ -0,0 +1,225 @@
make 的运行
===========
一般来说，最简单的就是直接在命令行下输入make命令，make命令会找当前目录的makefile来执行，一切
都是自动的。但也有时你也许只想让make重编译某些文件，而不是整个工程，而又有的时候你有几套编译规
则，你想在不同的时候使用不同的编译规则，等等。本章节就是讲述如何使用make命令的。
make的退出码
------------
make命令执行后有三个退出码：
0
表示成功执行。
1
如果make运行时出现任何错误，其返回1。
2
如果你使用了make的“-q”选项，并且make使得一些目标不需要更新，那么返回2。
Make的相关参数我们会在后续章节中讲述。
指定Makefile
------------
前面我们说过，GNU make找寻默认的Makefile的规则是在当前目录下依次找三个文件——“GNUmakefile”
、“makefile”和“Makefile”。其按顺序找这三个文件，一旦找到，就开始读取这个文件并执行。
当前，我们也可以给make命令指定一个特殊名字的Makefile。要达到这个功能，我们要使用make的
``-f`` 或是 ``--file`` 参数（ ``--makefile`` 参数也行）。例如，我们有个makefile的名字
是“hchen.mk”，那么，我们可以这样来让make来执行这个文件：
::
make –f hchen.mk
如果在make的命令行是，你不只一次地使用了 ``-f`` 参数，那么，所有指定的makefile将会被连在
一起传递给make执行。
指定目标
--------
一般来说，make的最终目标是makefile中的第一个目标，而其它目标一般是由这个目标连带出来的。这
是make的默认行为。当然，一般来说，你的makefile中的第一个目标是由许多个目标组成，你可以指
示make，让其完成你所指定的目标。要达到这一目的很简单，需在make命令后直接跟目标的名字就可以完成
（如前面提到的“make clean”形式）
任何在makefile中的目标都可以被指定成终极目标，但是除了以 ``-`` 打头，或是包含了 ``=`` 的
目标，因为有这些字符的目标，会被解析成命令行参数或是变量。甚至没有被我们明确写出来的目标也可以
成为make的终极目标，也就是说，只要make可以找到其隐含规则推导规则，那么这个隐含目标同样可以被指
定成终极目标。
有一个make的环境变量叫 ``MAKECMDGOALS`` ，这个变量中会存放你所指定的终极目标的列表，如果在
命令行上，你没有指定目标，那么，这个变量是空值。这个变量可以让你使用在一些比较特殊的情形下。比
如下面的例子：
.. code-block:: makefile
sources = foo.c bar.c
ifneq ( $(MAKECMDGOALS),clean)
include $(sources:.c=.d)
endif
基于上面的这个例子，只要我们输入的命令不是“make clean”，那么makefile会自动包含“foo.d”
和“bar.d”这两个makefile。
使用指定终极目标的方法可以很方便地让我们编译我们的程序，例如下面这个例子：
.. code-block:: makefile
.PHONY: all
all: prog1 prog2 prog3 prog4
从这个例子中，我们可以看到，这个makefile中有四个需要编译的程序——“prog1”， “prog2”，
“prog3”和 “prog4”，我们可以使用“make all”命令来编译所有的目标（如果把all置成第一个目标，
那么只需执行“make”），我们也可以使用 “make prog2”来单独编译目标“prog2”。
即然make可以指定所有makefile中的目标，那么也包括“伪目标”，于是我们可以根据这种性质来让我们
的makefile根据指定的不同的目标来完成不同的事。在Unix世界中，软件发布时，特别是GNU这种开源软
件的发布时，其makefile都包含了编译、安装、打包等功能。我们可以参照这种规则来书写我们
的makefile中的目标。
- all:这个伪目标是所有目标的目标，其功能一般是编译所有的目标。
- clean:这个伪目标功能是删除所有被make创建的文件。
- install:这个伪目标功能是安装已编译好的程序，其实就是把目标执行文件拷贝到指定的目标中去。
- print:这个伪目标的功能是例出改变过的源文件。
- tar:这个伪目标功能是把源程序打包备份。也就是一个tar文件。
- dist:这个伪目标功能是创建一个压缩文件，一般是把tar文件压成Z文件。或是gz文件。
- TAGS:这个伪目标功能是更新所有的目标，以备完整地重编译使用。
- check和test:这两个伪目标一般用来测试makefile的流程。
当然一个项目的makefile中也不一定要书写这样的目标，这些东西都是GNU的东西，但是我想，GNU搞出这
些东西一定有其可取之处（等你的 UNIX下的程序文件一多时你就会发现这些功能很有用了），这里只不过
是说明了，如果你要书写这种功能，最好使用这种名字命名你的目标，这样规范一些，规范的好处就是——不
用解释，大家都明白。而且如果你的makefile中有这些功能，一是很实用，二是可以显得你的makefile很
专业（不是那种初学者的作品）。
检查规则
--------
有时候，我们不想让我们的makefile中的规则执行起来，我们只想检查一下我们的命令，或是执行的序列。
于是我们可以使用make命令的下述参数：
``-n``, ``--just-print``, ``--dry-run``, ``--recon``
不执行参数，这些参数只是打印命令，不管目标是否更新，把规则和连带规则下的命令打印出来，但不
执行，这些参数对于我们调试makefile很有用处。
``-t``, ``--touch``
这个参数的意思就是把目标文件的时间更新，但不更改目标文件。也就是说，make假装编译目标，但不
是真正的编译目标，只是把目标变成已编译过的状态。
``-q``, ``--question``
这个参数的行为是找目标的意思，也就是说，如果目标存在，那么其什么也不会输出，当然也不会执行
编译，如果目标不存在，其会打印出一条出错信息。
``-W <file>``, ``--what-if=<file>``, ``--assume-new=<file>``, ``--new-file=<file>``
这个参数需要指定一个文件。一般是是源文件（或依赖文件），Make会根据规则推导来运行依赖于这个
文件的命令，一般来说，可以和“-n”参数一同使用，来查看这个依赖文件所发生的规则命令。
另外一个很有意思的用法是结合 ``-p`` 和 ``-v`` 来输出makefile被执行时的信息（这个将在后面讲述）。
make的参数
----------
下面列举了所有GNU make 3.80版的参数定义。其它版本和产商的make大同小异，不过其它产商的make的具体参数还是请参考各自的产品文档。
``-b``, ``-m``
这两个参数的作用是忽略和其它版本make的兼容性。
``-B``, ``--always-make``
认为所有的目标都需要更新（重编译）。
``-C`` *<dir>*, ``--directory``\ =\ *<dir>*
指定读取makefile的目录。如果有多个“-C”参数，make的解释是后面的路径以前面的作为相对路径
，并以最后的目录作为被指定目录。如：“make -C ~hchen/test -C prog”等价于
“make -C ~hchen/test/prog”。
``-debug``\ [=\ *<options>*]
输出make的调试信息。它有几种不同的级别可供选择，如果没有参数，那就是输出最简单的调试信息。
下面是<options>的取值：
- a: 也就是all，输出所有的调试信息。（会非常的多）
- b: 也就是basic，只输出简单的调试信息。即输出不需要重编译的目标。
- v: 也就是verbose，在b选项的级别之上。输出的信息包括哪个makefile被解析，不需要被重编
译的依赖文件（或是依赖目标）等。
- i: 也就是implicit，输出所以的隐含规则。
- j: 也就是jobs，输出执行规则中命令的详细信息，如命令的PID、返回码等。
- m: 也就是makefile，输出make读取makefile，更新makefile，执行makefile的信息。
``-d``
相当于“--debug=a”。
``-e``, ``--environment-overrides``
指明环境变量的值覆盖makefile中定义的变量的值。
``-f``\ =\ *<file>*, ``--file``\ =\ *<file>*, ``--makefile``\ =\ *<file>*
指定需要执行的makefile。
``-h``, ``--help``
显示帮助信息。
``-i`` , ``--ignore-errors``
在执行时忽略所有的错误。
``-I`` *<dir>*, ``--include-dir``\ =\ *<dir>*
指定一个被包含makefile的搜索目标。可以使用多个“-I”参数来指定多个目录。
``-j`` [*<jobsnum>*], ``--jobs``\ [=\ *<jobsnum>*]
指同时运行命令的个数。如果没有这个参数，make运行命令时能运行多少就运行多少。如果有一个以上的“-j”参数，那么仅最后一个“-j”才是有效的。（注意这个参数在MS-DOS中是无用的）
``-k``, ``--keep-going``
出错也不停止运行。如果生成一个目标失败了，那么依赖于其上的目标就不会被执行了。
``-l`` *<load>*, ``--load-average``\ [=\ *<load>*], ``-max-load``\ [=\ *<load>*]
指定make运行命令的负载。
``-n``, ``--just-print``, ``--dry-run``, ``--recon``
仅输出执行过程中的命令序列，但并不执行。
``-o`` *<file>*, ``--old-file``\ =\ *<file>*, ``--assume-old``\ =\ *<file>*
不重新生成的指定的<file>，即使这个目标的依赖文件新于它。
``-p``, ``--print-data-base``
输出makefile中的所有数据，包括所有的规则和变量。这个参数会让一个简单的makefile都会输出
一堆信息。如果你只是想输出信息而不想执行makefile，你可以使用“make -qp”命令。如果你想查
看执行makefile前的预设变量和规则，你可以使用 “make –p –f /dev/null”。这个参数输出的
信息会包含着你的makefile文件的文件名和行号，所以，用这个参数来调试你的 makefile会是很有
用的，特别是当你的环境变量很复杂的时候。
``-q``, ``--question``
不运行命令，也不输出。仅仅是检查所指定的目标是否需要更新。如果是0则说明要更新，如果是2则说
明有错误发生。
``-r``, ``--no-builtin-rules``
禁止make使用任何隐含规则。
``-R``, ``--no-builtin-variabes``
禁止make使用任何作用于变量上的隐含规则。
``-s``, ``--silent``, ``--quiet``
在命令运行时不输出命令的输出。
``-S``, ``--no-keep-going``, ``--stop``
取消“-k”选项的作用。因为有些时候，make的选项是从环境变量“MAKEFLAGS”中继承下来的。所以你
可以在命令行中使用这个参数来让环境变量中的“-k”选项失效。
``-t``, ``--touch``
相当于UNIX的touch命令，只是把目标的修改日期变成最新的，也就是阻止生成目标的命令运行。
``-v``, ``--version``
输出make程序的版本、版权等关于make的信息。
``-w``, ``--print-directory``
输出运行makefile之前和之后的信息。这个参数对于跟踪嵌套式调用make时很有用。
``--no-print-directory``
禁止“-w”选项。
``-W`` *<file>*, ``--what-if``\ =\ *<file>*, ``--new-file``\ =\ *<file>*, ``--assume-file``\ =\ *<file>*
假定目标<file>;需要更新，如果和“-n”选项使用，那么这个参数会输出该目标更新时的运行动作。
如果没有“-n”那么就像运行UNIX的“touch”命令一样，使得<file>;的修改时间为当前时间。
``--warn-undefined-variables``
只要make发现有未定义的变量，那么就输出警告信息。

53
_sources/overview.rst.txt Normal file
View File

@ -0,0 +1,53 @@
概述
====
什么是makefile？或许很多Windows的程序员都不知道这个东西，因为那些Windows的集成开发环境
（integrated development environment，IDE）都为你做了这个工作，但我觉得要作一个好的和专
业的程序员，makefile还是要懂。这就好像现在有这么多的HTML编辑器，但如果你想成为一个专业人士，
你还是要了解HTML的标签的含义。特别在Unix下的软件编译，你就不能不自己写makefile了，会不会
写makefile，从一个侧面说明了一个人是否具备完成大型工程的能力。
因为，makefile关系到了整个工程的编译规则。一个工程中的源文件不计其数，并且按类型、功能、模块分
别放在若干个目录中，makefile定义了一系列的规则来指定，哪些文件需要先编译，哪些文件需要后编译，
哪些文件需要重新编译，甚至于进行更复杂的功能操作，因为makefile就像一个Shell脚本一样，其中也可
以执行操作系统的命令。
makefile带来的好处就是——“自动化编译”，一旦写好，只需要一个make命令，整个工程完全自动编译，极
大的提高了软件开发的效率。 make是一个命令工具，是一个解释makefile中指令的命令工具，一般来说，
大多数的IDE都有这个命令，比如：Delphi的make，Visual C++的nmake，Linux下GNU的make。可见
，makefile都成为了一种在工程方面的编译方法。
现在讲述如何写makefile的文章比较少，这是我想写这篇文章的原因。当然，不同产商的make各不相同，
也有不同的语法，但其本质都是在 “文件依赖性”上做文章，这里，我仅对GNU的make进行讲述，我的环境
是RedHat Linux 8.0，make的版本是3.80。毕竟，这个make是应用最为广泛的，也是用得最多的。而且
其还是最遵循于IEEE 1003.2-1992标准的（POSIX.2）。
在这篇文档中，将以C/C++的源码作为基础，所以必然涉及一些关于C/C++的编译的知识。关于这方面的内
容，还请各位查看相关的编译器的文档。这里所默认的编译器是UNIX下的GCC和CC。
关于程序的编译和链接
--------------------
在此，我想多说关于程序编译的一些规范和方法。一般来说，无论是C还是C++，首先要把源文件编译成中间
代码文件，在Windows下也就是 ``.obj`` 文件，UNIX下是 ``.o`` 文件，即Object File，这个动
作叫做编译（compile）。然后再把大量的Object File合成执行文件，这个动作叫作链接（link）。
编译时，编译器需要的是语法的正确，函数与变量的声明的正确。对于后者，通常是你需要告诉编译器头文
件的所在位置（头文件中应该只是声明，而定义应该放在C/C++文件中），只要所有的语法正确，编译器就
可以编译出中间目标文件。一般来说，每个源文件都应该对应于一个中间目标文件（ ``.o`` 文件或
``.obj`` 文件）。
链接时，主要是链接函数和全局变量。所以，我们可以使用这些中间目标文件（ ``.o`` 文件或
``.obj`` 文件）来链接我们的应用程序。链接器并不管函数所在的源文件，只管函数的中间目标文件
（Object File），在大多数时候，由于源文件太多，编译生成的中间目标文件太多，而在链接时需要明显
地指出中间目标文件名，这对于编译很不方便。所以，我们要给中间目标文件打个包，在Windows下这种包
叫“库文件”（Library File），也就是 ``.lib`` 文件，在UNIX下，是Archive File，也就是
``.a`` 文件。
总结一下，源文件首先会生成中间目标文件，再由中间目标文件生成执行文件。在编译时，编译器只检测程
序语法和函数、变量是否被声明。如果函数未被声明，编译器会给出一个警告，但可以生成Object File。
而在链接程序时，链接器会在所有的Object File中找寻函数的实现，如果找不到，那到就会报链接错误码
（Linker Error），在VC下，这种错误一般是： ``Link 2001错误`` ，意思说是说，链接器未能找到
函数的实现。你需要指定函数的Object File。
好，言归正传，gnu的make有许多的内容，闲言少叙。

77
_sources/postscript.rst.txt Normal file
View File

@ -0,0 +1,77 @@
后序
====
终于到写结束语的时候了，以上基本上就是GNU make的Makefile的所有细节了。其它的厂商的make基本
上也就是这样的，无论什么样的make，都是以文件的依赖性为基础的，其基本是都是遵循一个标准的。这篇
文档中80%的技术细节都适用于任何的make，我猜测“函数”那一章的内容可能不是其它make所支持的，而隐
含规则方面，我想不同的make会有不同的实现，我没有精力来查看GNU的make和VC的nmake、BCB的 make
，或是别的UNIX下的make有些什么样的差别，一是时间精力不够，二是因为我基本上都是在Unix下使
用make，以前在SCO Unix和 IBM的AIX，现在在Linux、Solaris、HP-UX、AIX和Alpha下使用
，Linux和Solaris下更多一点。不过，我可以肯定的是，在Unix下的make，无论是哪种平台，几乎都使
用了Richard Stallman开发的make和cc/gcc的编译器，而且，基本上都是 GNU的make（公司里所有
的UNIX机器上都被装上了GNU的东西，所以，使用GNU的程序也就多了一些）。GNU的东西还是很不错的，特
别是使用得深了以后，越来越觉得GNU的软件的强大，也越来越觉得GNU的在操作系统中（主要是Unix，甚
至Windows）“杀伤力”。
对于上述所有的make的细节，我们不但可以利用make这个工具来编译我们的程序，还可以利用make来完成
其它的工作，因为规则中的命令可以是任何Shell之下的命令，所以，在Unix下，你不一定只是使用程序语
言的编译器，你还可以在Makefile中书写其它的命令，如：tar、 awk、mail、sed、cvs、compress
、ls、rm、yacc、rpm、ftp等等，等等，来完成诸如“程序打包”、“程序备份”、“制作程序安装包”、“提
交代码”、“使用程序模板”、“合并文件”等等五花八门的功能，文件操作，文件管理，编程开发设计，或是
其它一些异想天开的东西。比如，以前在书写银行交易程序时，由于银行的交易程序基本一样，就见到有人
书写了一些交易的通用程序模板，在该模板中把一些网络通讯、数据库操作的、业务操作共性的东西写在一
个文件中，在这些文件中用些诸如“@@@N、###N”奇怪字串标注一些位置，然后书写交易时，只需按照一种
特定的规则书写特定的处理，最后在make时，使用awk和sed，把模板中的“@@@N、###N”等字串替代成特
定的程序，形成C文件，然后再编译。这个动作很像数据库的“扩展C”语言（即在C语言中用“EXEC SQL”的
样子执行SQL语句，在用cc/gcc编译之前，需要使用“扩展C”的翻译程序，如cpre，把其翻译成标准C）。
如果你在使用make时有一些更为绝妙的方法，请记得告诉我啊。
回头看看整篇文档，不觉记起几年前刚刚开始在Unix下做开发的时候，有人问我会不会写Makefile时，我
两眼发直，根本不知道在说什么。一开始看到别人在vi中写完程序后输入“!make”时，还以为是vi的功能，
后来才知道有一个Makefile在作怪，于是上网查啊查，那时又不愿意看英文，发现就根本没有中文的文档介
绍Makefile，只得看别人写的Makefile，自己瞎碰瞎搞才积累了一点知识，但在很多地方完全是知其然不
知所以然。后来开始从事UNIX下产品软件的开发，看到一个400人，近200万行代码的大工程，发现要编译
这样一个庞然大物，如果没有Makefile，那会是多么恐怖的一样事啊。于是横下心来，狠命地读了一堆英文
文档，才觉得对其掌握了。但发现目前网上对Makefile介绍的文章还是少得那么的可怜，所以想写这样一篇
文章，共享给大家，希望能对各位有所帮助。
现在我终于写完了，看了看文件的创建时间，这篇技术文档也写了两个多月了。发现，自己知道是一回事，
要写下来，跟别人讲述又是另外一回事，而且，现在越来越没有时间钻研技术细节，所以在写作时，发现在
阐述一些细节问题时很难做到严谨和精炼，而且对先讲什么后讲什么不是很清楚，所以，还是参考了一些国
外站点上的资料和提纲，以及一些技术书籍的语言风格，才得以完成。整篇文档的提纲是基于GNU
的Makefile技术手册的提纲来书写的，并结合了自己的工作经验，以及自己的学习历程。因为从来没有写过
这么长，这么细的文档，所以一定会有很多地方存在表达问题，语言歧义或是错误。因些，我迫切地等待各
位给我指正和建议，以及任何的反馈。
最后，还是利用这个后序，介绍一下自己。我目前从事于所有Unix平台下的软件研发，主要是做分布式计
算/网格计算方面的系统产品软件，并且我对于下一代的计算机革命——网格计算非常地感兴趣，对于分布式计
算、P2P、Web Service、J2EE技术方向也很感兴趣，同时，对于项目实施、团队管理、项目管理也小有心
得，希望同样和我战斗在“技术和管理并重”的阵线上的年轻一代，能够和我多多地交流。我的MSN是：
haoel@hotmail.com（常用），QQ是：753640（不常用）。（注：请勿给我MSN的邮箱发信，由
于hotmail的垃圾邮件导致我拒收这个邮箱的所有来信）
我欢迎任何形式的交流，无论是讨论技术还是管理，或是其它海阔天空的东西。除了政治和娱乐新闻我不关
心，其它只要积极向上的东西我都欢迎！
最最后，我还想介绍一下make程序的设计开发者。
首当其冲的是：Richard Stallman
开源软件的领袖和先驱，从来没有领过一天工资，从来没有使用过Windows操作系统。对于他的事迹和他的
软件以及他的思想，我无需说过多的话，相信大家对这个人并不比我陌生，这是他的主页
：http://www.stallman.org/ 。这里只贴上一张他的近照：
http://bbs.chinaunix.net/attachments/rms.jpg
第二位是：Roland McGrath
个人主页是：http://www.frob.com/~roland/ ，下面是他的一些事迹：
#. 合作编写了并维护GNU make。
#. 和Thomas Bushnell一同编写了GNU Hurd。
#. 编写并维护着GNU C library。
#. 合作编写并维护着部分的GNU Emacs。
在此，向这两位开源项目的斗士致以最真切的敬意。
（全文完）

224
_sources/recipes.rst.txt Normal file
View File

@ -0,0 +1,224 @@
书写命令
========
每条规则中的命令和操作系统Shell的命令行是一致的。make会一按顺序一条一条的执行命令，每条命令的
开头必须以 ``Tab`` 键开头，除非，命令是紧跟在依赖规则后面的分号后的。在命令行之间中的空格或是
空行会被忽略，但是如果该空格或空行是以Tab键开头的，那么make会认为其是一个空命令。
我们在UNIX下可能会使用不同的Shell，但是make的命令默认是被 ``/bin/sh`` ——UNIX的标准Shell
解释执行的。除非你特别指定一个其它的Shell。Makefile中， ``#`` 是注释符，很像C/C++中的
``//`` ，其后的本行字符都被注释。
显示命令
--------
通常，make会把其要执行的命令行在命令执行前输出到屏幕上。当我们用 ``@`` 字符在命令行前，那么，
这个命令将不被make显示出来，最具代表性的例子是，我们用这个功能来向屏幕显示一些信息。如::
@echo 正在编译XXX模块......
当make执行时，会输出“正在编译XXX模块......”字串，但不会输出命令，如果没有“@”，那么，make将
输出::
echo 正在编译XXX模块......
正在编译XXX模块......
如果make执行时，带入make参数 ``-n`` 或 ``--just-print`` ，那么其只是显示命令，但不会执行
命令，这个功能很有利于我们调试我们的Makefile，看看我们书写的命令是执行起来是什么样子的或是什么
顺序的。
而make参数 ``-s`` 或 ``--silent`` 或 ``--quiet`` 则是全面禁止命令的显示。
命令执行
--------
当依赖目标新于目标时，也就是当规则的目标需要被更新时，make会一条一条的执行其后的命令。需要注意
的是，如果你要让上一条命令的结果应用在下一条命令时，你应该使用分号分隔这两条命令。比如你的第一
条命令是cd命令，你希望第二条命令得在cd之后的基础上运行，那么你就不能把这两条命令写在两行上，而
应该把这两条命令写在一行上，用分号分隔。如：
- 示例一：
.. code-block:: makefile
exec:
cd /home/hchen
pwd
- 示例二：
.. code-block:: makefile
exec:
cd /home/hchen; pwd
当我们执行 ``make exec`` 时，第一个例子中的cd没有作用，pwd会打印出当前的Makefile目录，而第
二个例子中，cd就起作用了，pwd会打印出“/home/hchen”。
make一般是使用环境变量SHELL中所定义的系统Shell来执行命令，默认情况下使用UNIX的标
准Shell——/bin/sh来执行命令。但在MS-DOS下有点特殊，因为MS-DOS下没有SHELL环境变量，当然你也
可以指定。如果你指定了UNIX风格的目录形式，首先，make会在SHELL所指定的路径中找寻命令解释器，如
果找不到，其会在当前盘符中的当前目录中寻找，如果再找不到，其会在PATH环境变量中所定义的所有路径
中寻找。MS-DOS中，如果你定义的命令解释器没有找到，其会给你的命令解释器加上诸如 ``.exe`` 、
``.com`` 、 ``.bat`` 、 ``.sh`` 等后缀。
命令出错
--------
每当命令运行完后，make会检测每个命令的返回码，如果命令返回成功，那么make会执行下一条命令，当规
则中所有的命令成功返回后，这个规则就算是成功完成了。如果一个规则中的某个命令出错了（命令退出码
非零），那么make就会终止执行当前规则，这将有可能终止所有规则的执行。
有些时候，命令的出错并不表示就是错误的。例如mkdir命令，我们一定需要建立一个目录，如果目录不存
在，那么mkdir就成功执行，万事大吉，如果目录存在，那么就出错了。我们之所以使用mkdir的意思就是
一定要有这样的一个目录，于是我们就不希望mkdir出错而终止规则的运行。
为了做到这一点，忽略命令的出错，我们可以在Makefile的命令行前加一个减号 ``-`` （在Tab键之后）
，标记为不管命令出不出错都认为是成功的。如：
.. code-block:: bash
clean:
-rm -f *.o
还有一个全局的办法是，给make加上 ``-i`` 或是 ``--ignore-errors`` 参数，那么，Makefile中
所有命令都会忽略错误。而如果一个规则是以 ``.IGNORE`` 作为目标的，那么这个规则中的所有命令将会
忽略错误。这些是不同级别的防止命令出错的方法，你可以根据你的不同喜欢设置。
还有一个要提一下的make的参数的是 ``-k`` 或是 ``--keep-going`` ，这个参数的意思是，如果某
规则中的命令出错了，那么就终止该规则的执行，但继续执行其它规则。
嵌套执行make
------------
在一些大的工程中，我们会把我们不同模块或是不同功能的源文件放在不同的目录中，我们可以在每个目录
中都书写一个该目录的Makefile，这有利于让我们的Makefile变得更加地简洁，而不至于把所有的东西全
部写在一个Makefile中，这样会很难维护我们的Makefile，这个技术对于我们模块编译和分段编译有着非
常大的好处。
例如，我们有一个子目录叫subdir，这个目录下有个Makefile文件，来指明了这个目录下文件的编译规则
。那么我们总控的Makefile可以这样书写：
.. code-block:: makefile
subsystem:
cd subdir && $(MAKE)
其等价于：
.. code-block:: makefile
subsystem:
$(MAKE) -C subdir
定义$(MAKE)宏变量的意思是，也许我们的make需要一些参数，所以定义成一个变量比较利于维护。这两个
例子的意思都是先进入“subdir”目录，然后执行make命令。
我们把这个Makefile叫做“总控Makefile”，总控Makefile的变量可以传递到下级的Makefile中（如果
你显示的声明），但是不会覆盖下层的Makefile中所定义的变量，除非指定了 ``-e`` 参数。
如果你要传递变量到下级Makefile中，那么你可以使用这样的声明::
export <variable ...>;
如果你不想让某些变量传递到下级Makefile中，那么你可以这样声明::
unexport <variable ...>;
如：
示例一：
.. code-block:: makefile
export variable = value
其等价于：
.. code-block:: makefile
variable = value
export variable
其等价于：
.. code-block:: makefile
export variable := value
其等价于：
.. code-block:: makefile
variable := value
export variable
示例二：
.. code-block:: makefile
export variable += value
其等价于：
.. code-block:: makefile
variable += value
export variable
如果你要传递所有的变量，那么，只要一个export就行了。后面什么也不用跟，表示传递所有的变量。
需要注意的是，有两个变量，一个是 ``SHELL`` ，一个是 ``MAKEFLAGS`` ，这两个变量不管你是
否export，其总是要传递到下层 Makefile中，特别是 ``MAKEFLAGS`` 变量，其中包含了make的参数
信息，如果我们执行“总控Makefile”时有make参数或是在上层 Makefile中定义了这个变量，那么
``MAKEFLAGS`` 变量将会是这些参数，并会传递到下层Makefile中，这是一个系统级的环境变量。
但是make命令中的有几个参数并不往下传递，它们是 ``-C`` , ``-f`` , ``-h``, ``-o`` 和
``-W`` （有关Makefile参数的细节将在后面说明），如果你不想往下层传递参数，那么，你可以这样来：
.. code-block:: makefile
subsystem:
cd subdir && $(MAKE) MAKEFLAGS=
如果你定义了环境变量 ``MAKEFLAGS`` ，那么你得确信其中的选项是大家都会用到的，如果其中有
``-t`` , ``-n`` 和 ``-q`` 参数，那么将会有让你意想不到的结果，或许会让你异常地恐慌。
还有一个在“嵌套执行”中比较有用的参数， ``-w`` 或是 ``--print-directory`` 会在make的过程
中输出一些信息，让你看到目前的工作目录。比如，如果我们的下级make目录
是“/home/hchen/gnu/make”，如果我们使用 ``make -w`` 来执行，那么当进入该目录时，我们会看
到::
make: Entering directory `/home/hchen/gnu/make'.
而在完成下层make后离开目录时，我们会看到::
make: Leaving directory `/home/hchen/gnu/make'
当你使用 ``-C`` 参数来指定make下层Makefile时， ``-w`` 会被自动打开的。如果参数中有
``-s`` （ ``--slient`` ）或是 ``--no-print-directory`` ，那么， ``-w`` 总是失效的。
定义命令包
----------
如果Makefile中出现一些相同命令序列，那么我们可以为这些相同的命令序列定义一个变量。定义这种命令
序列的语法以 ``define`` 开始，以 ``endef`` 结束，如::
define run-yacc
yacc $(firstword $^)
mv y.tab.c $@
endef
这里，“run-yacc”是这个命令包的名字，其不要和Makefile中的变量重名。在 ``define`` 和
``endef`` 中的两行就是命令序列。这个命令包中的第一个命令是运行Yacc程序，因为Yacc程序总是生
成“y.tab.c”的文件，所以第二行的命令就是把这个文件改改名字。还是把这个命令包放到一个示例中来看
看吧。
.. code-block:: makefile
foo.c : foo.y
$(run-yacc)
我们可以看见，要使用这个命令包，我们就好像使用变量一样。在这个命令包的使用中，命令
包“run-yacc”中的 ``$^`` 就是 ``foo.y`` ， ``$@`` 就是 ``foo.c`` （有关这种以 ``$``
开头的特殊变量，我们会在后面介绍），make在执行命令包时，命令包中的每个命令会被依次独立执行。

467
_sources/rules.rst.txt Normal file
View File

@ -0,0 +1,467 @@
书写规则
========
规则包含两个部分，一个是依赖关系，一个是生成目标的方法。
在Makefile中，规则的顺序是很重要的，因为，Makefile中只应该有一个最终目标，其它的目标都是被这
个目标所连带出来的，所以一定要让make知道你的最终目标是什么。一般来说，定义在Makefile中的目标
可能会有很多，但是第一条规则中的目标将被确立为最终的目标。如果第一条规则中的目标有很多个，那么
，第一个目标会成为最终的目标。make所完成的也就是这个目标。
好了，还是让我们来看一看如何书写规则。
规则举例
--------
.. code-block:: makefile
foo.o: foo.c defs.h # foo模块
cc -c -g foo.c
看到这个例子，各位应该不是很陌生了，前面也已说过， ``foo.o`` 是我们的目标， ``foo.c`` 和
``defs.h`` 是目标所依赖的源文件，而只有一个命令 ``cc -c -g foo.c`` （以Tab键开头）。这个
规则告诉我们两件事：
#. 文件的依赖关系， ``foo.o`` 依赖于 ``foo.c`` 和 ``defs.h`` 的文件，如果 ``foo.c``
和 ``defs.h`` 的文件日期要比 ``foo.o`` 文件日期要新，或是 ``foo.o`` 不存在，那么依赖
关系发生。
#. 生成或更新 ``foo.o`` 文件，就是那个cc命令。它说明了如何生成 ``foo.o`` 这个文件。
（当然，foo.c文件include了defs.h文件）
规则的语法
----------
.. code-block:: makefile
targets : prerequisites
command
...
或是这样：
.. code-block:: makefile
targets : prerequisites ; command
command
...
targets是文件名，以空格分开，可以使用通配符。一般来说，我们的目标基本上是一个文件，但也有可能
是多个文件。
command是命令行，如果其不与“target:prerequisites”在一行，那么，必须以 ``Tab`` 键开头，如
果和prerequisites在一行，那么可以用分号做为分隔。（见上）
prerequisites也就是目标所依赖的文件（或依赖目标）。如果其中的某个文件要比目标文件要新，那么，
目标就被认为是“过时的”，被认为是需要重生成的。这个在前面已经讲过了。
如果命令太长，你可以使用反斜杠（ ``\`` ）作为换行符。make对一行上有多少个字符没有限制。规则告
诉make两件事，文件的依赖关系和如何生成目标文件。
一般来说，make会以UNIX的标准Shell，也就是 ``/bin/sh`` 来执行命令。
在规则中使用通配符
------------------
如果我们想定义一系列比较类似的文件，我们很自然地就想起使用通配符。make支持三个通配符：
``*`` ， ``?`` 和 ``~`` 。这是和Unix的B-Shell是相同的。
波浪号（ ``~`` ）字符在文件名中也有比较特殊的用途。如果是 ``~/test`` ，这就表示当前用户
的 ``$HOME`` 目录下的test目录。而 ``~hchen/test`` 则表示用户hchen的宿主目录下的test
目录。（这些都是Unix下的小知识了，make也支持）而在Windows或是 MS-DOS下，用户没有宿主目录，
那么波浪号所指的目录则根据环境变量“HOME”而定。
通配符代替了你一系列的文件，如 ``*.c`` 表示所有后缀为c的文件。一个需要我们注意的是，如果我们
的文件名中有通配符，如： ``*`` ，那么可以用转义字符 ``\`` ，如 ``\*`` 来表示真实的 ``*``
字符，而不是任意长度的字符串。
好吧，还是先来看几个例子吧：
.. code-block:: makefile
clean:
rm -f *.o
其实在这个clean:后面可以加上你想做的一些事情，如果你想看到在编译完后看看main.c的源代码，你
可以在加上cat这个命令，例子如下：
.. code-block:: makefile
clean:
cat main.c
rm -f *.o
其结果你试一下就知道的。 上面这个例子我不不多说了，这是操作系统Shell所支持的通配符。这是在命令
中的通配符。
.. code-block:: makefile
print: *.c
lpr -p $?
touch print
上面这个例子说明了通配符也可以在我们的规则中，目标print依赖于所有的 ``.c`` 文件。其中的
``$?`` 是一个自动化变量，我会在后面给你讲述。
.. code-block:: makefile
objects = *.o
上面这个例子，表示了通配符同样可以用在变量中。并不是说 ``*.o`` 会展开，不！objects的值就是
``*.o`` 。Makefile中的变量其实就是C/C++中的宏。如果你要让通配符在变量中展开，也就是
让objects的值是所有 ``.o`` 的文件名的集合，那么，你可以这样：
.. code-block:: makefile
objects := $(wildcard *.o)
另给一个变量使用通配符的例子：
#. 列出一确定文件夹中的所有 ``.c`` 文件。
.. code-block:: makefile
objects := $(wildcard *.c)
#. 列出(1)中所有文件对应的 ``.o`` 文件，在（3）中我们可以看到它是由make自动编译出的::
$(patsubst %.c,%.o,$(wildcard *.c))
#. 由(1)(2)两步，可写出编译并链接所有 ``.c`` 和 ``.o`` 文件
.. code-block:: makefile
objects := $(patsubst %.c,%.o,$(wildcard *.c))
foo : $(objects)
cc -o foo $(objects)
这种用法由关键字“wildcard”，“patsubst”指出，关于Makefile的关键字，我们将在后面讨论。
文件搜寻
--------
在一些大的工程中，有大量的源文件，我们通常的做法是把这许多的源文件分类，并存放在不同的目录中。
所以，当make需要去找寻文件的依赖关系时，你可以在文件前加上路径，但最好的方法是把一个路径告
诉make，让make在自动去找。
Makefile文件中的特殊变量 ``VPATH`` 就是完成这个功能的，如果没有指明这个变量，make只会在当前
的目录中去找寻依赖文件和目标文件。如果定义了这个变量，那么，make就会在当前目录找不到的情况下
，到所指定的目录中去找寻文件了。
.. code-block:: makefile
VPATH = src:../headers
上面的定义指定两个目录，“src”和“../headers”，make会按照这个顺序进行搜索。目录由“冒号”分隔
。（当然，当前目录永远是最高优先搜索的地方）
另一个设置文件搜索路径的方法是使用make的“vpath”关键字（注意，它是全小写的），这不是变量，这是
一个make的关键字，这和上面提到的那个VPATH变量很类似，但是它更为灵活。它可以指定不同的文件在不
同的搜索目录中。这是一个很灵活的功能。它的使用方法有三种：
``vpath <pattern> <directories>``
为符合模式<pattern>的文件指定搜索目录<directories>。
``vpath <pattern>``
清除符合模式<pattern>的文件的搜索目录。
``vpath``
清除所有已被设置好了的文件搜索目录。
vpath使用方法中的<pattern>需要包含 ``%`` 字符。 ``%`` 的意思是匹配零或若干字符，（需引用
``%`` ，使用 ``\`` ）例如， ``%.h`` 表示所有以 ``.h`` 结尾的文件。<pattern>指定了要搜索
的文件集，而<directories>则指定了< pattern>的文件集的搜索的目录。例如：
.. code-block:: makefile
vpath %.h ../headers
该语句表示，要求make在“../headers”目录下搜索所有以 ``.h`` 结尾的文件。（如果某文件在当前目
录没有找到的话）
我们可以连续地使用vpath语句，以指定不同搜索策略。如果连续的vpath语句中出现了相同的<pattern>
，或是被重复了的<pattern>，那么，make会按照vpath语句的先后顺序来执行搜索。如：
.. code-block:: makefile
vpath %.c foo
vpath % blish
vpath %.c bar
其表示 ``.c`` 结尾的文件，先在“foo”目录，然后是“blish”，最后是“bar”目录。
.. code-block:: makefile
vpath %.c foo:bar
vpath % blish
而上面的语句则表示 ``.c`` 结尾的文件，先在“foo”目录，然后是“bar”目录，最后才是“blish”目录。
伪目标
------
最早先的一个例子中，我们提到过一个“clean”的目标，这是一个“伪目标”，
.. code-block:: makefile
clean:
rm *.o temp
正像我们前面例子中的“clean”一样，既然我们生成了许多文件编译文件，我们也应该提供一个清除它们的“
目标”以备完整地重编译而用。 （以“make clean”来使用该目标）
因为，我们并不生成“clean”这个文件。“伪目标”并不是一个文件，只是一个标签，由于“伪目标”不是
文件，所以make无法生成它的依赖关系和决定它是否要执行。我们只有通过显式地指明这个“目标”才能让其
生效。当然，“伪目标”的取名不能和文件名重名，不然其就失去了“伪目标”的意义了。
当然，为了避免和文件重名的这种情况，我们可以使用一个特殊的标记“.PHONY”来显式地指明一个目标是“
伪目标”，向make说明，不管是否有这个文件，这个目标就是“伪目标”。
.. code-block:: makefile
.PHONY : clean
只要有这个声明，不管是否有“clean”文件，要运行“clean”这个目标，只有“make clean”这样。于是整
个过程可以这样写：
.. code-block:: makefile
.PHONY : clean
clean :
rm *.o temp
伪目标一般没有依赖的文件。但是，我们也可以为伪目标指定所依赖的文件。伪目标同样可以作为“默认目
标”，只要将其放在第一个。一个示例就是，如果你的Makefile需要一口气生成若干个可执行文件，但你只
想简单地敲一个make完事，并且，所有的目标文件都写在一个Makefile中，那么你可以使用“伪目标”这个
特性：
.. code-block:: makefile
all : prog1 prog2 prog3
.PHONY : all
prog1 : prog1.o utils.o
cc -o prog1 prog1.o utils.o
prog2 : prog2.o
cc -o prog2 prog2.o
prog3 : prog3.o sort.o utils.o
cc -o prog3 prog3.o sort.o utils.o
我们知道，Makefile中的第一个目标会被作为其默认目标。我们声明了一个“all”的伪目标，其依赖于其它
三个目标。由于默认目标的特性是，总是被执行的，但由于“all”又是一个伪目标，伪目标只是一个标签不
会生成文件，所以不会有“all”文件产生。于是，其它三个目标的规则总是会被决议。也就达到了我们一口
气生成多个目标的目的。 ``.PHONY : all`` 声明了“all”这个目标为“伪目标”。（注：这里的显式
“.PHONY : all” 不写的话一般情况也可以正确的执行，这样make可通过隐式规则推导出， “all” 是一
个伪目标，执行make不会生成“all”文件，而执行后面的多个目标。建议：显式写出是一个好习惯。）
随便提一句，从上面的例子我们可以看出，目标也可以成为依赖。所以，伪目标同样也可成为依赖。看下面
的例子：
.. code-block:: makefile
.PHONY : cleanall cleanobj cleandiff
cleanall : cleanobj cleandiff
rm program
cleanobj :
rm *.o
cleandiff :
rm *.diff
“make cleanall”将清除所有要被清除的文件。“cleanobj”和“cleandiff”这两个伪目标有点像“子程
序”的意思。我们可以输入“make cleanall”和“make cleanobj”和“make cleandiff”命令来达到清
除不同种类文件的目的。
多目标
------
Makefile的规则中的目标可以不止一个，其支持多目标，有可能我们的多个目标同时依赖于一个文件，并且
其生成的命令大体类似。于是我们就能把其合并起来。当然，多个目标的生成规则的执行命令不是同一个，
这可能会给我们带来麻烦，不过好在我们可以使用一个自动化变量 ``$@`` （关于自动化变量，将在后面讲
述），这个变量表示着目前规则中所有的目标的集合，这样说可能很抽象，还是看一个例子吧。
.. code-block:: makefile
bigoutput littleoutput : text.g
generate text.g -$(subst output,,$@) > $@
上述规则等价于：
.. code-block:: makefile
bigoutput : text.g
generate text.g -big > bigoutput
littleoutput : text.g
generate text.g -little > littleoutput
其中， ``-$(subst output,,$@)`` 中的 ``$`` 表示执行一个Makefile的函数，函数名为subst，
后面的为参数。关于函数，将在后面讲述。这里的这个函数是替换字符串的意思， ``$@`` 表示目标的
集合，就像一个数组， ``$@`` 依次取出目标，并执于命令。
静态模式
--------
静态模式可以更加容易地定义多目标的规则，可以让我们的规则变得更加的有弹性和灵活。我们还是先来
看一下语法：
.. code-block:: makefile
<targets ...> : <target-pattern> : <prereq-patterns ...>
<commands>
...
targets定义了一系列的目标文件，可以有通配符。是目标的一个集合。
target-pattern是指明了targets的模式，也就是的目标集模式。
prereq-patterns是目标的依赖模式，它对target-pattern形成的模式再进行一次依赖目标的定义。
这样描述这三个东西，可能还是没有说清楚，还是举个例子来说明一下吧。如果我们
的<target-pattern>定义成 ``%.o`` ，意思是我们的<target>;集合中都是以 ``.o`` 结尾的，而
如果我们的<prereq-patterns>定义成 ``%.c`` ，意思是对<target-pattern>所形成的目标集进
行二次定义，其计算方法是，取<target-pattern>模式中的 ``%`` （也就是去掉了 ``.o`` 这个结
尾），并为其加上 ``.c`` 这个结尾，形成的新集合。
所以，我们的“目标模式”或是“依赖模式”中都应该有 ``%`` 这个字符，如果你的文件名中有 ``%`` 那么
你可以使用反斜杠 ``\`` 进行转义，来标明真实的 ``%`` 字符。
看一个例子：
.. code-block:: makefile
objects = foo.o bar.o
all: $(objects)
$(objects): %.o: %.c
$(CC) -c $(CFLAGS) $< -o $@
上面的例子中，指明了我们的目标从$object中获取， ``%.o`` 表明要所有以 ``.o`` 结尾的目标，也
就是 ``foo.o bar.o`` ，也就是变量 ``$object`` 集合的模式，而依赖模式 ``%.c`` 则取模式
``%.o`` 的 ``%`` ，也就是 ``foo bar`` ，并为其加下 ``.c`` 的后缀，于是，我们的依赖目标就
是 ``foo.c bar.c`` 。而命令中的 ``$<`` 和 ``$@`` 则是自动化变量， ``$<`` 表示第一个依赖文件，
``$@`` 表示目标集（也就是“foo.o bar.o”）。于是，上面
的规则展开后等价于下面的规则：
.. code-block:: makefile
foo.o : foo.c
$(CC) -c $(CFLAGS) foo.c -o foo.o
bar.o : bar.c
$(CC) -c $(CFLAGS) bar.c -o bar.o
试想，如果我们的 ``%.o`` 有几百个，那么我们只要用这种很简单的“静态模式规则”就可以写完一堆
规则，实在是太有效率了。“静态模式规则”的用法很灵活，如果用得好，那会是一个很强大的功能。再看一
个例子：
.. code-block:: makefile
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 $<
$(filter %.o,$(files))表示调用Makefile的filter函数，过滤“$files”集，只要其中模式
为“%.o”的内容。其它的内容，我就不用多说了吧。这个例子展示了Makefile中更大的弹性。
自动生成依赖性
--------------
在Makefile中，我们的依赖关系可能会需要包含一系列的头文件，比如，如果我们的main.c中有一句
``#include "defs.h"`` ，那么我们的依赖关系应该是：
.. code-block:: makefile
main.o : main.c defs.h
但是，如果是一个比较大型的工程，你必需清楚哪些C文件包含了哪些头文件，并且，你在加入或删除头文件
时，也需要小心地修改Makefile，这是一个很没有维护性的工作。为了避免这种繁重而又容易出错的事情，
我们可以使用C/C++编译的一个功能。大多数的C/C++编译器都支持一个“-M”的选项，即自动找寻源文件中
包含的头文件，并生成一个依赖关系。例如，如果我们执行下面的命令::
cc -M main.c
其输出是：
.. code-block:: makefile
main.o : main.c defs.h
于是由编译器自动生成的依赖关系，这样一来，你就不必再手动书写若干文件的依赖关系，而由编译器自动
生成了。需要提醒一句的是，如果你使用GNU的C/C++编译器，你得用 ``-MM`` 参数，不然， ``-M``
参数会把一些标准库的头文件也包含进来。
gcc -M main.c的输出是::
main.o: main.c defs.h /usr/include/stdio.h /usr/include/features.h \
/usr/include/sys/cdefs.h /usr/include/gnu/stubs.h \
/usr/lib/gcc-lib/i486-suse-linux/2.95.3/include/stddef.h \
/usr/include/bits/types.h /usr/include/bits/pthreadtypes.h \
/usr/include/bits/sched.h /usr/include/libio.h \
/usr/include/_G_config.h /usr/include/wchar.h \
/usr/include/bits/wchar.h /usr/include/gconv.h \
/usr/lib/gcc-lib/i486-suse-linux/2.95.3/include/stdarg.h \
/usr/include/bits/stdio_lim.h
gcc -MM main.c的输出则是::
main.o: main.c defs.h
那么，编译器的这个功能如何与我们的Makefile联系在一起呢。因为这样一来，我们的Makefile也要根据
这些源文件重新生成，让 Makefile自已依赖于源文件？这个功能并不现实，不过我们可以有其它手段来迂
回地实现这一功能。GNU组织建议把编译器为每一个源文件的自动生成的依赖关系放到一个文件中，为每一
个 ``name.c`` 的文件都生成一个 ``name.d`` 的Makefile文件， ``.d`` 文件中就存放对应
``.c`` 文件的依赖关系。
于是，我们可以写出 ``.c`` 文件和 ``.d`` 文件的依赖关系，并让make自动更新或生成 ``.d``
文件，并把其包含在我们的主Makefile中，这样，我们就可以自动化地生成每个文件的依赖关系了。
这里，我们给出了一个模式规则来产生 ``.d`` 文件：
.. code-block:: makefile
%.d: %.c
@set -e; rm -f $@; \
$(CC) -M $(CPPFLAGS) $< > $@.$$$$; \
sed 's,\($*\)\.o[ :]*,\1.o $@ : ,g' < $@.$$$$ > $@; \
rm -f $@.$$$$
这个规则的意思是，所有的 ``.d`` 文件依赖于 ``.c`` 文件， ``rm -f $@`` 的意思是删除所有的
目标，也就是 ``.d`` 文件，第二行的意思是，为每个依赖文件 ``$<`` ，也就是 ``.c`` 文件生成依
赖文件， ``$@`` 表示模式 ``%.d`` 文件，如果有一个C文件是name.c，那么 ``%`` 就是
``name`` ， ``$$$$`` 意为一个随机编号，第二行生成的文件有可能是“name.d.12345”，第三行使
用sed命令做了一个替换，关于sed命令的用法请参看相关的使用文档。第四行就是删除临时文件。
总而言之，这个模式要做的事就是在编译器生成的依赖关系中加入 ``.d`` 文件的依赖，即把依赖关系：
.. code-block:: makefile
main.o : main.c defs.h
转成：
.. code-block:: makefile
main.o main.d : main.c defs.h
于是，我们的 ``.d`` 文件也会自动更新了，并会自动生成了，当然，你还可以在这个 ``.d`` 文件中
加入的不只是依赖关系，包括生成的命令也可一并加入，让每个 ``.d`` 文件都包含一个完赖的规则。一旦
我们完成这个工作，接下来，我们就要把这些自动生成的规则放进我们的主Makefile中。我们可以使
用Makefile的“include”命令，来引入别的Makefile文件（前面讲过），例如：
.. code-block:: makefile
sources = foo.c bar.c
include $(sources:.c=.d)
上述语句中的 ``$(sources:.c=.d)`` 中的 ``.c=.d`` 的意思是做一个替换，把变量
``$(sources)`` 所有 ``.c`` 的字串都替换成 ``.d`` ，关于这个“替换”的内容，在后面我会有更为
详细的讲述。当然，你得注意次序，因为include是按次序来载入文件，最先载入的 ``.d`` 文件中的目
标会成为默认目标。

471
_sources/variables.rst.txt Normal file
View File

@ -0,0 +1,471 @@
使用变量
========
在Makefile中的定义的变量，就像是C/C++语言中的宏一样，他代表了一个文本字串，在Makefile中
执行的时候其会自动原模原样地展开在所使用的地方。其与C/C++所不同的是，你可以在Makefile中改变其
值。在Makefile中，变量可以使用在“目标”，“依赖目标”， “命令”或是Makefile的其它部分中。
变量的命名字可以包含字符、数字，下划线（可以是数字开头），但不应该含有 ``:`` 、 ``#`` 、
``=`` 或是空字符（空格、回车等）。变量是大小写敏感的，“foo”、“Foo”和“FOO”是三个不同的
变量名。传统的Makefile的变量名是全大写的命名方式，但我推荐使用大小写搭配的变量名，如：
MakeFlags。这样可以避免和系统的变量冲突，而发生意外的事情。
有一些变量是很奇怪字串，如 ``$<`` 、 ``$@`` 等，这些是自动化变量，我会在后面介绍。
变量的基础
----------
变量在声明时需要给予初值，而在使用时，需要给在变量名前加上 ``$`` 符号，但最好用小括号
``()`` 或是大括号 ``{}`` 把变量给包括起来。如果你要使用真实的 ``$`` 字符，那么你需要用
``$$`` 来表示。
变量可以使用在许多地方，如规则中的“目标”、“依赖”、“命令”以及新的变量中。先看一个例子：
.. code-block:: makefile
objects = program.o foo.o utils.o
program : $(objects)
cc -o program $(objects)
$(objects) : defs.h
变量会在使用它的地方精确地展开，就像C/C++中的宏一样，例如：
.. code-block:: makefile
foo = c
prog.o : prog.$(foo)
$(foo)$(foo) -$(foo) prog.$(foo)
展开后得到：
.. code-block:: makefile
prog.o : prog.c
cc -c prog.c
当然，千万不要在你的Makefile中这样干，这里只是举个例子来表明Makefile中的变量在使用处展开的
真实样子。可见其就是一个“替代”的原理。
另外，给变量加上括号完全是为了更加安全地使用这个变量，在上面的例子中，如果你不想给变量加上
括号，那也可以，但我还是强烈建议你给变量加上括号。
变量中的变量
------------
在定义变量的值时，我们可以使用其它变量来构造变量的值，在Makefile中有两种方式来在用变量定义
变量的值。
先看第一种方式，也就是简单的使用 ``=`` 号，在 ``=`` 左侧是变量，右侧是变量的值，右侧变量的值
可以定义在文件的任何一处，也就是说，右侧中的变量不一定非要是已定义好的值，其也可以使用后面定义的值。如：
.. code-block:: makefile
foo = $(bar)
bar = $(ugh)
ugh = Huh?
all:
echo $(foo)
我们执行“make all”将会打出变量 ``$(foo)`` 的值是 ``Huh?`` （ ``$(foo)`` 的值是
``$(bar)`` ， ``$(bar)`` 的值是 ``$(ugh)`` ， ``$(ugh)`` 的值是 ``Huh?`` ）可见，变
量是可以使用后面的变量来定义的。
这个功能有好的地方，也有不好的地方，好的地方是，我们可以把变量的真实值推到后面来定义，如：
.. code-block:: makefile
CFLAGS = $(include_dirs) -O
include_dirs = -Ifoo -Ibar
当 ``CFLAGS`` 在命令中被展开时，会是 ``-Ifoo -Ibar -O`` 。但这种形式也有不好的地方，那就
是递归定义，如：
.. code-block:: makefile
CFLAGS = $(CFLAGS) -O
或：
.. code-block:: makefile
A = $(B)
B = $(A)
这会让make陷入无限的变量展开过程中去，当然，我们的make是有能力检测这样的定义，并会报错。还有就
是如果在变量中使用函数，那么，这种方式会让我们的make运行时非常慢，更糟糕的是，他会使用得两
个make的函数“wildcard”和“shell”发生不可预知的错误。因为你不会知道这两个函数会被调用多少次。
为了避免上面的这种方法，我们可以使用make中的另一种用变量来定义变量的方法。这种方法使用的是 ``:=`` 操作符，如：
.. code-block:: makefile
x := foo
y := $(x) bar
x := later
其等价于：
.. code-block:: makefile
y := foo bar
x := later
值得一提的是，这种方法，前面的变量不能使用后面的变量，只能使用前面已定义好了的变量。如果是这样：
.. code-block:: makefile
y := $(x) bar
x := foo
那么，y的值是“bar”，而不是“foo bar”。
上面都是一些比较简单的变量使用了，让我们来看一个复杂的例子，其中包括了make的函数、条件表达式和
一个系统变量“MAKELEVEL”的使用：
.. code-block:: makefile
ifeq (0,${MAKELEVEL})
cur-dir := $(shell pwd)
whoami := $(shell whoami)
host-type := $(shell arch)
MAKE := ${MAKE} host-type=${host-type} whoami=${whoami}
endif
关于条件表达式和函数，我们在后面再说，对于系统变量“MAKELEVEL”，其意思是，如果我们的make有一
个嵌套执行的动作（参见前面的“嵌套使用make”），那么，这个变量会记录了我们的当前Makefile的调用
层数。
下面再介绍两个定义变量时我们需要知道的，请先看一个例子，如果我们要定义一个变量，其值是一个
空格，那么我们可以这样来：
.. code-block:: makefile
nullstring :=
space := $(nullstring) # end of the line
nullstring是一个Empty变量，其中什么也没有，而我们的space的值是一个空格。因为在操作符的右边
是很难描述一个空格的，这里采用的技术很管用，先用一个Empty变量来标明变量的值开始了，而后面采
用“#”注释符来表示变量定义的终止，这样，我们可以定义出其值是一个空格的变量。请注意这里关于“#”的
使用，注释符“#”的这种特性值得我们注意，如果我们这样定义一个变量：
.. code-block:: makefile
dir := /foo/bar # directory to put the frobs in
dir这个变量的值是“/foo/bar”，后面还跟了4个空格，如果我们这样使用这样变量来指定别的目
录——“$(dir)/file”那么就完蛋了。
还有一个比较有用的操作符是 ``?=`` ，先看示例：
.. code-block:: makefile
FOO ?= bar
其含义是，如果FOO没有被定义过，那么变量FOO的值就是“bar”，如果FOO先前被定义过，那么这条语将
什么也不做，其等价于：
.. code-block:: makefile
ifeq ($(origin FOO), undefined)
FOO = bar
endif
变量高级用法
------------
这里介绍两种变量的高级使用方法，第一种是变量值的替换。
我们可以替换变量中的共有的部分，其格式是 ``$(var:a=b)`` 或是 ``${var:a=b}`` ，其意思是，
把变量“var”中所有以“a”字串“结尾”的“a”替换成“b”字串。这里的“结尾”意思是“空格”或是“结束符”。
还是看一个示例吧：
.. code-block:: makefile
foo := a.o b.o c.o
bar := $(foo:.o=.c)
这个示例中，我们先定义了一个 ``$(foo)`` 变量，而第二行的意思是把 ``$(foo)`` 中所有以
``.o`` 字串“结尾”全部替换成 ``.c`` ，所以我们的 ``$(bar)`` 的值就是“a.c b.c c.c”。
另外一种变量替换的技术是以“静态模式”（参见前面章节）定义的，如：
.. code-block:: makefile
foo := a.o b.o c.o
bar := $(foo:%.o=%.c)
这依赖于被替换字串中的有相同的模式，模式中必须包含一个 ``%`` 字符，这个例子同样让
``$(bar)`` 变量的值为“a.c b.c c.c”。
第二种高级用法是——“把变量的值再当成变量”。先看一个例子：
.. code-block:: makefile
x = y
y = z
a := $($(x))
在这个例子中，$(x)的值是“y”，所以$($(x))就是$(y)，于是$(a)的值就是“z”。（注意，是“x=y”，
而不是“x=$(y)”）
我们还可以使用更多的层次：
.. code-block:: makefile
x = y
y = z
z = u
a := $($($(x)))
这里的 ``$(a)`` 的值是“u”，相关的推导留给读者自己去做吧。
让我们再复杂一点，使用上“在变量定义中使用变量”的第一个方式，来看一个例子：
.. code-block:: makefile
x = $(y)
y = z
z = Hello
a := $($(x))
这里的 ``$($(x))`` 被替换成了 ``$($(y))`` ，因为 ``$(y)`` 值是“z”，所以，最终结果是：
``a:=$(z)`` ，也就是“Hello”。
再复杂一点，我们再加上函数：
.. code-block:: makefile
x = variable1
variable2 := Hello
y = $(subst 1,2,$(x))
z = y
a := $($($(z)))
这个例子中， ``$($($(z)))`` 扩展为 ``$($(y))`` ，而其再次被扩展为
``$($(subst 1,2,$(x)))`` 。 ``$(x)`` 的值是“variable1”，subst函数把“variable1”中的
所有“1”字串替换成“2”字串，于是，“variable1”变成 “variable2”，再取其值，所以，最终，
``$(a)`` 的值就是 ``$(variable2)`` 的值——“Hello”。（喔，好不容易）
在这种方式中，或要可以使用多个变量来组成一个变量的名字，然后再取其值：
.. code-block:: makefile
first_second = Hello
a = first
b = second
all = $($a_$b)
这里的 ``$a_$b`` 组成了“first_second”，于是， ``$(all)`` 的值就是“Hello”。
再来看看结合第一种技术的例子：
.. code-block:: makefile
a_objects := a.o b.o c.o
1_objects := 1.o 2.o 3.o
sources := $($(a1)_objects:.o=.c)
这个例子中，如果 ``$(a1)`` 的值是“a”的话，那么， ``$(sources)`` 的值就是“a.c b.c c.c”；
如果 ``$(a1)`` 的值是“1”，那么 ``$(sources)`` 的值是“1.c 2.c 3.c”。
再来看一个这种技术和“函数”与“条件语句”一同使用的例子：
.. code-block:: makefile
ifdef do_sort
func := sort
else
func := strip
endif
bar := a d b g q c
foo := $($(func) $(bar))
这个示例中，如果定义了“do_sort”，那么： ``foo := $(sort a d b g q c)`` ，于是
``$(foo)`` 的值就是 “a b c d g q”，而如果没有定义“do_sort”，那么：
``foo := $(strip a d b g q c)`` ，调用的就是strip函数。
当然，“把变量的值再当成变量”这种技术，同样可以用在操作符的左边::
dir = foo
$(dir)_sources := $(wildcard $(dir)/*.c)
define $(dir)_print
lpr $($(dir)_sources)
endef
这个例子中定义了三个变量：“dir”，“foo_sources”和“foo_print”。
追加变量值
----------
我们可以使用 ``+=`` 操作符给变量追加值，如：
.. code-block:: makefile
objects = main.o foo.o bar.o utils.o
objects += another.o
于是，我们的 ``$(objects)`` 值变成：“main.o foo.o bar.o utils.o another.o”（another.o被追加进去了）
使用 ``+=`` 操作符，可以模拟为下面的这种例子：
.. code-block:: makefile
objects = main.o foo.o bar.o utils.o
objects := $(objects) another.o
所不同的是，用 ``+=`` 更为简洁。
如果变量之前没有定义过，那么， ``+=`` 会自动变成 ``=`` ，如果前面有变量定义，那么 ``+=`` 会
继承于前次操作的赋值符。如果前一次的是 ``:=`` ，那么 ``+=`` 会以 ``:=`` 作为其赋值符，如：
.. code-block:: makefile
variable := value
variable += more
等价于：
.. code-block:: makefile
variable := value
variable := $(variable) more
但如果是这种情况：
.. code-block:: makefile
variable = value
variable += more
由于前次的赋值符是 ``=`` ，所以 ``+=`` 也会以 ``=`` 来做为赋值，那么岂不会发生变量的递补归
定义，这是很不好的，所以make会自动为我们解决这个问题，我们不必担心这个问题。
override 指示符
---------------
如果有变量是通常make的命令行参数设置的，那么Makefile中对这个变量的赋值会被忽略。如果你想
在Makefile中设置这类参数的值，那么，你可以使用“override”指示符。其语法是::
override <variable>; = <value>;
override <variable>; := <value>;
当然，你还可以追加::
override <variable>; += <more text>;
对于多行的变量定义，我们用define指示符，在define指示符前，也同样可以使用override指示符，
如::
override define foo
bar
endef
多行变量
--------
还有一种设置变量值的方法是使用define关键字。使用define关键字设置变量的值可以有换行，这有利于
定义一系列的命令（前面我们讲过“命令包”的技术就是利用这个关键字）。
define指示符后面跟的是变量的名字，而重起一行定义变量的值，定义是以endef 关键字结束。其工作方
式和“=”操作符一样。变量的值可以包含函数、命令、文字，或是其它变量。因为命令需要以[Tab]键开头，
所以如果你用define定义的命令变量中没有以 ``Tab`` 键开头，那么make 就不会把其认为是命令。
下面的这个示例展示了define的用法::
define two-lines
echo foo
echo $(bar)
endef
环境变量
--------
make运行时的系统环境变量可以在make开始运行时被载入到Makefile文件中，但是如果Makefile中已
定义了这个变量，或是这个变量由make命令行带入，那么系统的环境变量的值将被覆盖。（如果make指定
了“-e”参数，那么，系统环境变量将覆盖Makefile中定义的变量）
因此，如果我们在环境变量中设置了 ``CFLAGS`` 环境变量，那么我们就可以在所有的Makefile中使用
这个变量了。这对于我们使用统一的编译参数有比较大的好处。如果Makefile中定义了CFLAGS，那么则会
使用Makefile中的这个变量，如果没有定义则使用系统环境变量的值，一个共性和个性的统一，很像“全局
变量”和“局部变量”的特性。
当make嵌套调用时（参见前面的“嵌套调用”章节），上层Makefile中定义的变量会以系统环境变量的方式
传递到下层的Makefile 中。当然，默认情况下，只有通过命令行设置的变量会被传递。而定义在文件中的
变量，如果要向下层Makefile传递，则需要使用export关键字来声明。（参见前面章节）
当然，我并不推荐把许多的变量都定义在系统环境中，这样，在我们执行不用的Makefile时，拥有的是同一
套系统变量，这可能会带来更多的麻烦。
目标变量
--------
前面我们所讲的在Makefile中定义的变量都是“全局变量”，在整个文件，我们都可以访问这些变量。
当然，“自动化变量”除外，如 ``$<`` 等这种类量的自动化变量就属于“规则型变量”，这种变量的值依赖
于规则的目标和依赖目标的定义。
当然，我也同样可以为某个目标设置局部变量，这种变量被称为“Target-specific Variable”，它可以
和“全局变量”同名，因为它的作用范围只在这条规则以及连带规则中，所以其值也只在作用范围内有效。而
不会影响规则链以外的全局变量的值。
其语法是：
.. code-block:: makefile
<target ...> : <variable-assignment>;
<target ...> : overide <variable-assignment>
<variable-assignment>;可以是前面讲过的各种赋值表达式，如 ``=`` 、 ``:=`` 、 ``+=``
或是 ``?=`` 。第二个语法是针对于make命令行带入的变量，或是系统环境变量。
这个特性非常的有用，当我们设置了这样一个变量，这个变量会作用到由这个目标所引发的所有的规则中
去。如：
.. code-block:: makefile
prog : CFLAGS = -g
prog : prog.o foo.o bar.o
$(CC) $(CFLAGS) prog.o foo.o bar.o
prog.o : prog.c
$(CC) $(CFLAGS) prog.c
foo.o : foo.c
$(CC) $(CFLAGS) foo.c
bar.o : bar.c
$(CC) $(CFLAGS) bar.c
在这个示例中，不管全局的 ``$(CFLAGS)`` 的值是什么，在prog目标，以及其所引发的所有规则
中（prog.o foo.o bar.o的规则）， ``$(CFLAGS)`` 的值都是 ``-g``
模式变量
--------
在GNU的make中，还支持模式变量（Pattern-specific Variable），通过上面的目标变量中，我们
知道，变量可以定义在某个目标上。模式变量的好处就是，我们可以给定一种“模式”，可以把变量定义在符
合这种模式的所有目标上。
我们知道，make的“模式”一般是至少含有一个 ``%`` 的，所以，我们可以以如下方式给所有以 ``.o``
结尾的目标定义目标变量：
.. code-block:: makefile
%.o : CFLAGS = -O
同样，模式变量的语法和“目标变量”一样：
.. code-block:: makefile
<pattern ...>; : <variable-assignment>;
<pattern ...>; : override <variable-assignment>;
override同样是针对于系统环境传入的变量，或是make命令行指定的变量。

906
_static/basic.css Normal file
View File

@ -0,0 +1,906 @@
/*
* basic.css
* ~~~~~~~~~
*
* Sphinx stylesheet -- basic theme.
*
* :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
* :license: BSD, see LICENSE for details.
*
*/
/* -- main layout ----------------------------------------------------------- */
div.clearer {
clear: both;
}
div.section::after {
display: block;
content: '';
clear: left;
}
/* -- relbar ---------------------------------------------------------------- */
div.related {
width: 100%;
font-size: 90%;
}
div.related h3 {
display: none;
}
div.related ul {
margin: 0;
padding: 0 0 0 10px;
list-style: none;
}
div.related li {
display: inline;
}
div.related li.right {
float: right;
margin-right: 5px;
}
/* -- sidebar --------------------------------------------------------------- */
div.sphinxsidebarwrapper {
padding: 10px 5px 0 10px;
}
div.sphinxsidebar {
float: left;
width: 230px;
margin-left: -100%;
font-size: 90%;
word-wrap: break-word;
overflow-wrap : break-word;
}
div.sphinxsidebar ul {
list-style: none;
}
div.sphinxsidebar ul ul,
div.sphinxsidebar ul.want-points {
margin-left: 20px;
list-style: square;
}
div.sphinxsidebar ul ul {
margin-top: 0;
margin-bottom: 0;
}
div.sphinxsidebar form {
margin-top: 10px;
}
div.sphinxsidebar input {
border: 1px solid #98dbcc;
font-family: sans-serif;
font-size: 1em;
}
div.sphinxsidebar #searchbox form.search {
overflow: hidden;
}
div.sphinxsidebar #searchbox input[type="text"] {
float: left;
width: 80%;
padding: 0.25em;
box-sizing: border-box;
}
div.sphinxsidebar #searchbox input[type="submit"] {
float: left;
width: 20%;
border-left: none;
padding: 0.25em;
box-sizing: border-box;
}
img {
border: 0;
max-width: 100%;
}
/* -- search page ----------------------------------------------------------- */
ul.search {
margin: 10px 0 0 20px;
padding: 0;
}
ul.search li {
padding: 5px 0 5px 20px;
background-image: url(file.png);
background-repeat: no-repeat;
background-position: 0 7px;
}
ul.search li a {
font-weight: bold;
}
ul.search li p.context {
color: #888;
margin: 2px 0 0 30px;
text-align: left;
}
ul.keywordmatches li.goodmatch a {
font-weight: bold;
}
/* -- index page ------------------------------------------------------------ */
table.contentstable {
width: 90%;
margin-left: auto;
margin-right: auto;
}
table.contentstable p.biglink {
line-height: 150%;
}
a.biglink {
font-size: 1.3em;
}
span.linkdescr {
font-style: italic;
padding-top: 5px;
font-size: 90%;
}
/* -- general index --------------------------------------------------------- */
table.indextable {
width: 100%;
}
table.indextable td {
text-align: left;
vertical-align: top;
}
table.indextable ul {
margin-top: 0;
margin-bottom: 0;
list-style-type: none;
}
table.indextable > tbody > tr > td > ul {
padding-left: 0em;
}
table.indextable tr.pcap {
height: 10px;
}
table.indextable tr.cap {
margin-top: 10px;
background-color: #f2f2f2;
}
img.toggler {
margin-right: 3px;
margin-top: 3px;
cursor: pointer;
}
div.modindex-jumpbox {
border-top: 1px solid #ddd;
border-bottom: 1px solid #ddd;
margin: 1em 0 1em 0;
padding: 0.4em;
}
div.genindex-jumpbox {
border-top: 1px solid #ddd;
border-bottom: 1px solid #ddd;
margin: 1em 0 1em 0;
padding: 0.4em;
}
/* -- domain module index --------------------------------------------------- */
table.modindextable td {
padding: 2px;
border-collapse: collapse;
}
/* -- general body styles --------------------------------------------------- */
div.body {
min-width: 450px;
max-width: 800px;
}
div.body p, div.body dd, div.body li, div.body blockquote {
-moz-hyphens: auto;
-ms-hyphens: auto;
-webkit-hyphens: auto;
hyphens: auto;
}
a.headerlink {
visibility: hidden;
}
a.brackets:before,
span.brackets > a:before{
content: "[";
}
a.brackets:after,
span.brackets > a:after {
content: "]";
}
h1:hover > a.headerlink,
h2:hover > a.headerlink,
h3:hover > a.headerlink,
h4:hover > a.headerlink,
h5:hover > a.headerlink,
h6:hover > a.headerlink,
dt:hover > a.headerlink,
caption:hover > a.headerlink,
p.caption:hover > a.headerlink,
div.code-block-caption:hover > a.headerlink {
visibility: visible;
}
div.body p.caption {
text-align: inherit;
}
div.body td {
text-align: left;
}
.first {
margin-top: 0 !important;
}
p.rubric {
margin-top: 30px;
font-weight: bold;
}
img.align-left, figure.align-left, .figure.align-left, object.align-left {
clear: left;
float: left;
margin-right: 1em;
}
img.align-right, figure.align-right, .figure.align-right, object.align-right {
clear: right;
float: right;
margin-left: 1em;
}
img.align-center, figure.align-center, .figure.align-center, object.align-center {
display: block;
margin-left: auto;
margin-right: auto;
}
img.align-default, figure.align-default, .figure.align-default {
display: block;
margin-left: auto;
margin-right: auto;
}
.align-left {
text-align: left;
}
.align-center {
text-align: center;
}
.align-default {
text-align: center;
}
.align-right {
text-align: right;
}
/* -- sidebars -------------------------------------------------------------- */
div.sidebar,
aside.sidebar {
margin: 0 0 0.5em 1em;
border: 1px solid #ddb;
padding: 7px;
background-color: #ffe;
width: 40%;
float: right;
clear: right;
overflow-x: auto;
}
p.sidebar-title {
font-weight: bold;
}
div.admonition, div.topic, blockquote {
clear: left;
}
/* -- topics ---------------------------------------------------------------- */
div.topic {
border: 1px solid #ccc;
padding: 7px;
margin: 10px 0 10px 0;
}
p.topic-title {
font-size: 1.1em;
font-weight: bold;
margin-top: 10px;
}
/* -- admonitions ----------------------------------------------------------- */
div.admonition {
margin-top: 10px;
margin-bottom: 10px;
padding: 7px;
}
div.admonition dt {
font-weight: bold;
}
p.admonition-title {
margin: 0px 10px 5px 0px;
font-weight: bold;
}
div.body p.centered {
text-align: center;
margin-top: 25px;
}
/* -- content of sidebars/topics/admonitions -------------------------------- */
div.sidebar > :last-child,
aside.sidebar > :last-child,
div.topic > :last-child,
div.admonition > :last-child {
margin-bottom: 0;
}
div.sidebar::after,
aside.sidebar::after,
div.topic::after,
div.admonition::after,
blockquote::after {
display: block;
content: '';
clear: both;
}
/* -- tables ---------------------------------------------------------------- */
table.docutils {
margin-top: 10px;
margin-bottom: 10px;
border: 0;
border-collapse: collapse;
}
table.align-center {
margin-left: auto;
margin-right: auto;
}
table.align-default {
margin-left: auto;
margin-right: auto;
}
table caption span.caption-number {
font-style: italic;
}
table caption span.caption-text {
}
table.docutils td, table.docutils th {
padding: 1px 8px 1px 5px;
border-top: 0;
border-left: 0;
border-right: 0;
border-bottom: 1px solid #aaa;
}
table.footnote td, table.footnote th {
border: 0 !important;
}
th {
text-align: left;
padding-right: 5px;
}
table.citation {
border-left: solid 1px gray;
margin-left: 1px;
}
table.citation td {
border-bottom: none;
}
th > :first-child,
td > :first-child {
margin-top: 0px;
}
th > :last-child,
td > :last-child {
margin-bottom: 0px;
}
/* -- figures --------------------------------------------------------------- */
div.figure, figure {
margin: 0.5em;
padding: 0.5em;
}
div.figure p.caption, figcaption {
padding: 0.3em;
}
div.figure p.caption span.caption-number,
figcaption span.caption-number {
font-style: italic;
}
div.figure p.caption span.caption-text,
figcaption span.caption-text {
}
/* -- field list styles ----------------------------------------------------- */
table.field-list td, table.field-list th {
border: 0 !important;
}
.field-list ul {
margin: 0;
padding-left: 1em;
}
.field-list p {
margin: 0;
}
.field-name {
-moz-hyphens: manual;
-ms-hyphens: manual;
-webkit-hyphens: manual;
hyphens: manual;
}
/* -- hlist styles ---------------------------------------------------------- */
table.hlist {
margin: 1em 0;
}
table.hlist td {
vertical-align: top;
}
/* -- object description styles --------------------------------------------- */
.sig {
font-family: 'Consolas', 'Menlo', 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', monospace;
}
.sig-name, code.descname {
background-color: transparent;
font-weight: bold;
}
.sig-name {
font-size: 1.1em;
}
code.descname {
font-size: 1.2em;
}
.sig-prename, code.descclassname {
background-color: transparent;
}
.optional {
font-size: 1.3em;
}
.sig-paren {
font-size: larger;
}
.sig-param.n {
font-style: italic;
}
/* C++ specific styling */
.sig-inline.c-texpr,
.sig-inline.cpp-texpr {
font-family: unset;
}
.sig.c .k, .sig.c .kt,
.sig.cpp .k, .sig.cpp .kt {
color: #0033B3;
}
.sig.c .m,
.sig.cpp .m {
color: #1750EB;
}
.sig.c .s, .sig.c .sc,
.sig.cpp .s, .sig.cpp .sc {
color: #067D17;
}
/* -- other body styles ----------------------------------------------------- */
ol.arabic {
list-style: decimal;
}
ol.loweralpha {
list-style: lower-alpha;
}
ol.upperalpha {
list-style: upper-alpha;
}
ol.lowerroman {
list-style: lower-roman;
}
ol.upperroman {
list-style: upper-roman;
}
:not(li) > ol > li:first-child > :first-child,
:not(li) > ul > li:first-child > :first-child {
margin-top: 0px;
}
:not(li) > ol > li:last-child > :last-child,
:not(li) > ul > li:last-child > :last-child {
margin-bottom: 0px;
}
ol.simple ol p,
ol.simple ul p,
ul.simple ol p,
ul.simple ul p {
margin-top: 0;
}
ol.simple > li:not(:first-child) > p,
ul.simple > li:not(:first-child) > p {
margin-top: 0;
}
ol.simple p,
ul.simple p {
margin-bottom: 0;
}
dl.footnote > dt,
dl.citation > dt {
float: left;
margin-right: 0.5em;
}
dl.footnote > dd,
dl.citation > dd {
margin-bottom: 0em;
}
dl.footnote > dd:after,
dl.citation > dd:after {
content: "";
clear: both;
}
dl.field-list {
display: grid;
grid-template-columns: fit-content(30%) auto;
}
dl.field-list > dt {
font-weight: bold;
word-break: break-word;
padding-left: 0.5em;
padding-right: 5px;
}
dl.field-list > dt:after {
content: ":";
}
dl.field-list > dd {
padding-left: 0.5em;
margin-top: 0em;
margin-left: 0em;
margin-bottom: 0em;
}
dl {
margin-bottom: 15px;
}
dd > :first-child {
margin-top: 0px;
}
dd ul, dd table {
margin-bottom: 10px;
}
dd {
margin-top: 3px;
margin-bottom: 10px;
margin-left: 30px;
}
dl > dd:last-child,
dl > dd:last-child > :last-child {
margin-bottom: 0;
}
dt:target, span.highlighted {
background-color: #fbe54e;
}
rect.highlighted {
fill: #fbe54e;
}
dl.glossary dt {
font-weight: bold;
font-size: 1.1em;
}
.versionmodified {
font-style: italic;
}
.system-message {
background-color: #fda;
padding: 5px;
border: 3px solid red;
}
.footnote:target {
background-color: #ffa;
}
.line-block {
display: block;
margin-top: 1em;
margin-bottom: 1em;
}
.line-block .line-block {
margin-top: 0;
margin-bottom: 0;
margin-left: 1.5em;
}
.guilabel, .menuselection {
font-family: sans-serif;
}
.accelerator {
text-decoration: underline;
}
.classifier {
font-style: oblique;
}
.classifier:before {
font-style: normal;
margin: 0 0.5em;
content: ":";
display: inline-block;
}
abbr, acronym {
border-bottom: dotted 1px;
cursor: help;
}
/* -- code displays --------------------------------------------------------- */
pre {
overflow: auto;
overflow-y: hidden; /* fixes display issues on Chrome browsers */
}
pre, div[class*="highlight-"] {
clear: both;
}
span.pre {
-moz-hyphens: none;
-ms-hyphens: none;
-webkit-hyphens: none;
hyphens: none;
white-space: nowrap;
}
div[class*="highlight-"] {
margin: 1em 0;
}
td.linenos pre {
border: 0;
background-color: transparent;
color: #aaa;
}
table.highlighttable {
display: block;
}
table.highlighttable tbody {
display: block;
}
table.highlighttable tr {
display: flex;
}
table.highlighttable td {
margin: 0;
padding: 0;
}
table.highlighttable td.linenos {
padding-right: 0.5em;
}
table.highlighttable td.code {
flex: 1;
overflow: hidden;
}
.highlight .hll {
display: block;
}
div.highlight pre,
table.highlighttable pre {
margin: 0;
}
div.code-block-caption + div {
margin-top: 0;
}
div.code-block-caption {
margin-top: 1em;
padding: 2px 5px;
font-size: small;
}
div.code-block-caption code {
background-color: transparent;
}
table.highlighttable td.linenos,
span.linenos,
div.highlight span.gp { /* gp: Generic.Prompt */
user-select: none;
-webkit-user-select: text; /* Safari fallback only */
-webkit-user-select: none; /* Chrome/Safari */
-moz-user-select: none; /* Firefox */
-ms-user-select: none; /* IE10+ */
}
div.code-block-caption span.caption-number {
padding: 0.1em 0.3em;
font-style: italic;
}
div.code-block-caption span.caption-text {
}
div.literal-block-wrapper {
margin: 1em 0;
}
code.xref, a code {
background-color: transparent;
font-weight: bold;
}
h1 code, h2 code, h3 code, h4 code, h5 code, h6 code {
background-color: transparent;
}
.viewcode-link {
float: right;
}
.viewcode-back {
float: right;
font-family: sans-serif;
}
div.viewcode-block:target {
margin: -1px -10px;
padding: 0 10px;
}
/* -- math display ---------------------------------------------------------- */
img.math {
vertical-align: middle;
}
div.body div.math p {
text-align: center;
}
span.eqno {
float: right;
}
span.eqno a.headerlink {
position: absolute;
z-index: 1;
}
div.math:hover a.headerlink {
visibility: visible;
}
/* -- printout stylesheet --------------------------------------------------- */
@media print {
div.document,
div.documentwrapper,
div.bodywrapper {
margin: 0 !important;
width: 100%;
}
div.sphinxsidebar,
div.related,
div.footer,
#top-link {
display: none;
}
}

1
_static/css/badge_only.css Normal file
View File

@ -0,0 +1 @@
.fa:before{-webkit-font-smoothing:antialiased}.clearfix{*zoom:1}.clearfix:after,.clearfix:before{display:table;content:""}.clearfix:after{clear:both}@font-face{font-family:FontAwesome;font-style:normal;font-weight:400;src:url(fonts/fontawesome-webfont.eot?674f50d287a8c48dc19ba404d20fe713?#iefix) format("embedded-opentype"),url(fonts/fontawesome-webfont.woff2?af7ae505a9eed503f8b8e6982036873e) format("woff2"),url(fonts/fontawesome-webfont.woff?fee66e712a8a08eef5805a46892932ad) format("woff"),url(fonts/fontawesome-webfont.ttf?b06871f281fee6b241d60582ae9369b9) format("truetype"),url(fonts/fontawesome-webfont.svg?912ec66d7572ff821749319396470bde#FontAwesome) format("svg")}.fa:before{font-family:FontAwesome;font-style:normal;font-weight:400;line-height:1}.fa:before,a .fa{text-decoration:inherit}.fa:before,a .fa,li .fa{display:inline-block}li .fa-large:before{width:1.875em}ul.fas{list-style-type:none;margin-left:2em;text-indent:-.8em}ul.fas li .fa{width:.8em}ul.fas li .fa-large:before{vertical-align:baseline}.fa-book:before,.icon-book:before{content:"\f02d"}.fa-caret-down:before,.icon-caret-down:before{content:"\f0d7"}.fa-caret-up:before,.icon-caret-up:before{content:"\f0d8"}.fa-caret-left:before,.icon-caret-left:before{content:"\f0d9"}.fa-caret-right:before,.icon-caret-right:before{content:"\f0da"}.rst-versions{position:fixed;bottom:0;left:0;width:300px;color:#fcfcfc;background:#1f1d1d;font-family:Lato,proxima-nova,Helvetica Neue,Arial,sans-serif;z-index:400}.rst-versions a{color:#2980b9;text-decoration:none}.rst-versions .rst-badge-small{display:none}.rst-versions .rst-current-version{padding:12px;background-color:#272525;display:block;text-align:right;font-size:90%;cursor:pointer;color:#27ae60}.rst-versions .rst-current-version:after{clear:both;content:"";display:block}.rst-versions .rst-current-version .fa{color:#fcfcfc}.rst-versions .rst-current-version .fa-book,.rst-versions .rst-current-version .icon-book{float:left}.rst-versions .rst-current-version.rst-out-of-date{background-color:#e74c3c;color:#fff}.rst-versions .rst-current-version.rst-active-old-version{background-color:#f1c40f;color:#000}.rst-versions.shift-up{height:auto;max-height:100%;overflow-y:scroll}.rst-versions.shift-up .rst-other-versions{display:block}.rst-versions .rst-other-versions{font-size:90%;padding:12px;color:grey;display:none}.rst-versions .rst-other-versions hr{display:block;height:1px;border:0;margin:20px 0;padding:0;border-top:1px solid #413d3d}.rst-versions .rst-other-versions dd{display:inline-block;margin:0}.rst-versions .rst-other-versions dd a{display:inline-block;padding:6px;color:#fcfcfc}.rst-versions.rst-badge{width:auto;bottom:20px;right:20px;left:auto;border:none;max-width:300px;max-height:90%}.rst-versions.rst-badge .fa-book,.rst-versions.rst-badge .icon-book{float:none;line-height:30px}.rst-versions.rst-badge.shift-up .rst-current-version{text-align:right}.rst-versions.rst-badge.shift-up .rst-current-version .fa-book,.rst-versions.rst-badge.shift-up .rst-current-version .icon-book{float:left}.rst-versions.rst-badge>.rst-current-version{width:auto;height:30px;line-height:30px;padding:0 6px;display:block;text-align:center}@media screen and (max-width:768px){.rst-versions{width:85%;display:none}.rst-versions.shift{display:block}}

BIN
_static/css/fonts/Roboto-Slab-Bold.woff Normal file
View File

Binary file not shown.

BIN
_static/css/fonts/Roboto-Slab-Bold.woff2 Normal file
View File

Binary file not shown.

BIN
_static/css/fonts/Roboto-Slab-Regular.woff Normal file
View File

Binary file not shown.

BIN
_static/css/fonts/Roboto-Slab-Regular.woff2 Normal file
View File

Binary file not shown.

BIN
_static/css/fonts/fontawesome-webfont.eot Normal file
View File

Binary file not shown.

2671
_static/css/fonts/fontawesome-webfont.svg Normal file
View File

File diff suppressed because it is too large Load Diff
Side by Side

After

Width:  |  Height:  |  Size: 434 KiB

BIN
_static/css/fonts/fontawesome-webfont.ttf Normal file
View File

Binary file not shown.

BIN
_static/css/fonts/fontawesome-webfont.woff Normal file
View File

Binary file not shown.

BIN
_static/css/fonts/fontawesome-webfont.woff2 Normal file
View File

Binary file not shown.

BIN
_static/css/fonts/lato-bold-italic.woff Normal file
View File

Binary file not shown.

BIN
_static/css/fonts/lato-bold-italic.woff2 Normal file
View File

Binary file not shown.

BIN
_static/css/fonts/lato-bold.woff Normal file
View File

Binary file not shown.

BIN
_static/css/fonts/lato-bold.woff2 Normal file
View File

Binary file not shown.

BIN
_static/css/fonts/lato-normal-italic.woff Normal file
View File

Binary file not shown.

BIN
_static/css/fonts/lato-normal-italic.woff2 Normal file
View File

Binary file not shown.

BIN
_static/css/fonts/lato-normal.woff Normal file
View File

Binary file not shown.

BIN
_static/css/fonts/lato-normal.woff2 Normal file
View File

Binary file not shown.

4
_static/css/theme.css Normal file
View File

File diff suppressed because one or more lines are too long

358
_static/doctools.js Normal file
View File

@ -0,0 +1,358 @@
/*
* doctools.js
* ~~~~~~~~~~~
*
* Sphinx JavaScript utilities for all documentation.
*
* :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
* :license: BSD, see LICENSE for details.
*
*/
/**
* select a different prefix for underscore
*/
$u = _.noConflict();
/**
* make the code below compatible with browsers without
* an installed firebug like debugger
if (!window.console || !console.firebug) {
var names = ["log", "debug", "info", "warn", "error", "assert", "dir",
"dirxml", "group", "groupEnd", "time", "timeEnd", "count", "trace",
"profile", "profileEnd"];
window.console = {};
for (var i = 0; i < names.length; ++i)
window.console[names[i]] = function() {};
}
*/
/**
* small helper function to urldecode strings
*
* See https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/decodeURIComponent#Decoding_query_parameters_from_a_URL
*/
jQuery.urldecode = function(x) {
if (!x) {
return x
}
return decodeURIComponent(x.replace(/\+/g, ' '));
};
/**
* small helper function to urlencode strings
*/
jQuery.urlencode = encodeURIComponent;
/**
* This function returns the parsed url parameters of the
* current request. Multiple values per key are supported,
* it will always return arrays of strings for the value parts.
*/
jQuery.getQueryParameters = function(s) {
if (typeof s === 'undefined')
s = document.location.search;
var parts = s.substr(s.indexOf('?') + 1).split('&');
var result = {};
for (var i = 0; i < parts.length; i++) {
var tmp = parts[i].split('=', 2);
var key = jQuery.urldecode(tmp[0]);
var value = jQuery.urldecode(tmp[1]);
if (key in result)
result[key].push(value);
else
result[key] = [value];
}
return result;
};
/**
* highlight a given string on a jquery object by wrapping it in
* span elements with the given class name.
*/
jQuery.fn.highlightText = function(text, className) {
function highlight(node, addItems) {
if (node.nodeType === 3) {
var val = node.nodeValue;
var pos = val.toLowerCase().indexOf(text);
if (pos >= 0 &&
!jQuery(node.parentNode).hasClass(className) &&
!jQuery(node.parentNode).hasClass("nohighlight")) {
var span;
var isInSVG = jQuery(node).closest("body, svg, foreignObject").is("svg");
if (isInSVG) {
span = document.createElementNS("http://www.w3.org/2000/svg", "tspan");
} else {
span = document.createElement("span");
span.className = className;
}
span.appendChild(document.createTextNode(val.substr(pos, text.length)));
node.parentNode.insertBefore(span, node.parentNode.insertBefore(
document.createTextNode(val.substr(pos + text.length)),
node.nextSibling));
node.nodeValue = val.substr(0, pos);
if (isInSVG) {
var rect = document.createElementNS("http://www.w3.org/2000/svg", "rect");
var bbox = node.parentElement.getBBox();
rect.x.baseVal.value = bbox.x;
rect.y.baseVal.value = bbox.y;
rect.width.baseVal.value = bbox.width;
rect.height.baseVal.value = bbox.height;
rect.setAttribute('class', className);
addItems.push({
"parent": node.parentNode,
"target": rect});
}
}
}
else if (!jQuery(node).is("button, select, textarea")) {
jQuery.each(node.childNodes, function() {
highlight(this, addItems);
});
}
}
var addItems = [];
var result = this.each(function() {
highlight(this, addItems);
});
for (var i = 0; i < addItems.length; ++i) {
jQuery(addItems[i].parent).before(addItems[i].target);
}
return result;
};
/*
* backward compatibility for jQuery.browser
* This will be supported until firefox bug is fixed.
*/
if (!jQuery.browser) {
jQuery.uaMatch = function(ua) {
ua = ua.toLowerCase();
var match = /(chrome)[ \/]([\w.]+)/.exec(ua) ||
/(webkit)[ \/]([\w.]+)/.exec(ua) ||
/(opera)(?:.*version|)[ \/]([\w.]+)/.exec(ua) ||
/(msie) ([\w.]+)/.exec(ua) ||
ua.indexOf("compatible") < 0 && /(mozilla)(?:.*? rv:([\w.]+)|)/.exec(ua) ||
[];
return {
browser: match[ 1 ] || "",
version: match[ 2 ] || "0"
};
};
jQuery.browser = {};
jQuery.browser[jQuery.uaMatch(navigator.userAgent).browser] = true;
}
/**
* Small JavaScript module for the documentation.
*/
var Documentation = {
init : function() {
this.fixFirefoxAnchorBug();
this.highlightSearchWords();
this.initIndexTable();
this.initOnKeyListeners();
},
/**
* i18n support
*/
TRANSLATIONS : {},
PLURAL_EXPR : function(n) { return n === 1 ? 0 : 1; },
LOCALE : 'unknown',
// gettext and ngettext don't access this so that the functions
// can safely bound to a different name (_ = Documentation.gettext)
gettext : function(string) {
var translated = Documentation.TRANSLATIONS[string];
if (typeof translated === 'undefined')
return string;
return (typeof translated === 'string') ? translated : translated[0];
},
ngettext : function(singular, plural, n) {
var translated = Documentation.TRANSLATIONS[singular];
if (typeof translated === 'undefined')
return (n == 1) ? singular : plural;
return translated[Documentation.PLURALEXPR(n)];
},
addTranslations : function(catalog) {
for (var key in catalog.messages)
this.TRANSLATIONS[key] = catalog.messages[key];
this.PLURAL_EXPR = new Function('n', 'return +(' + catalog.plural_expr + ')');
this.LOCALE = catalog.locale;
},
/**
* add context elements like header anchor links
*/
addContextElements : function() {
$('div[id] > :header:first').each(function() {
$('<a class="headerlink">\u00B6</a>').
attr('href', '#' + this.id).
attr('title', _('Permalink to this headline')).
appendTo(this);
});
$('dt[id]').each(function() {
$('<a class="headerlink">\u00B6</a>').
attr('href', '#' + this.id).
attr('title', _('Permalink to this definition')).
appendTo(this);
});
},
/**
* workaround a firefox stupidity
* see: https://bugzilla.mozilla.org/show_bug.cgi?id=645075
*/
fixFirefoxAnchorBug : function() {
if (document.location.hash && $.browser.mozilla)
window.setTimeout(function() {
document.location.href += '';
}, 10);
},
/**
* highlight the search words provided in the url in the text
*/
highlightSearchWords : function() {
var params = $.getQueryParameters();
var terms = (params.highlight) ? params.highlight[0].split(/\s+/) : [];
if (terms.length) {
var body = $('div.body');
if (!body.length) {
body = $('body');
}
window.setTimeout(function() {
$.each(terms, function() {
body.highlightText(this.toLowerCase(), 'highlighted');
});
}, 10);
$('<p class="highlight-link"><a href="javascript:Documentation.' +
'hideSearchWords()">' + _('Hide Search Matches') + '</a></p>')
.appendTo($('#searchbox'));
}
},
/**
* init the domain index toggle buttons
*/
initIndexTable : function() {
var togglers = $('img.toggler').click(function() {
var src = $(this).attr('src');
var idnum = $(this).attr('id').substr(7);
$('tr.cg-' + idnum).toggle();
if (src.substr(-9) === 'minus.png')
$(this).attr('src', src.substr(0, src.length-9) + 'plus.png');
else
$(this).attr('src', src.substr(0, src.length-8) + 'minus.png');
}).css('display', '');
if (DOCUMENTATION_OPTIONS.COLLAPSE_INDEX) {
togglers.click();
}
},
/**
* helper function to hide the search marks again
*/
hideSearchWords : function() {
$('#searchbox .highlight-link').fadeOut(300);
$('span.highlighted').removeClass('highlighted');
var url = new URL(window.location);
url.searchParams.delete('highlight');
window.history.replaceState({}, '', url);
},
/**
* helper function to focus on search bar
*/
focusSearchBar : function() {
$('input[name=q]').first().focus();
},
/**
* make the url absolute
*/
makeURL : function(relativeURL) {
return DOCUMENTATION_OPTIONS.URL_ROOT + '/' + relativeURL;
},
/**
* get the current relative url
*/
getCurrentURL : function() {
var path = document.location.pathname;
var parts = path.split(/\//);
$.each(DOCUMENTATION_OPTIONS.URL_ROOT.split(/\//), function() {
if (this === '..')
parts.pop();
});
var url = parts.join('/');
return path.substring(url.lastIndexOf('/') + 1, path.length - 1);
},
initOnKeyListeners: function() {
// only install a listener if it is really needed
if (!DOCUMENTATION_OPTIONS.NAVIGATION_WITH_KEYS &&
!DOCUMENTATION_OPTIONS.ENABLE_SEARCH_SHORTCUTS)
return;
$(document).keydown(function(event) {
var activeElementType = document.activeElement.tagName;
// don't navigate when in search box, textarea, dropdown or button
if (activeElementType !== 'TEXTAREA' && activeElementType !== 'INPUT' && activeElementType !== 'SELECT'
&& activeElementType !== 'BUTTON') {
if (event.altKey || event.ctrlKey || event.metaKey)
return;
if (!event.shiftKey) {
switch (event.key) {
case 'ArrowLeft':
if (!DOCUMENTATION_OPTIONS.NAVIGATION_WITH_KEYS)
break;
var prevHref = $('link[rel="prev"]').prop('href');
if (prevHref) {
window.location.href = prevHref;
return false;
}
break;
case 'ArrowRight':
if (!DOCUMENTATION_OPTIONS.NAVIGATION_WITH_KEYS)
break;
var nextHref = $('link[rel="next"]').prop('href');
if (nextHref) {
window.location.href = nextHref;
return false;
}
break;
case 'Escape':
if (!DOCUMENTATION_OPTIONS.ENABLE_SEARCH_SHORTCUTS)
break;
Documentation.hideSearchWords();
return false;
}
}
// some keyboard layouts may need Shift to get /
switch (event.key) {
case '/':
if (!DOCUMENTATION_OPTIONS.ENABLE_SEARCH_SHORTCUTS)
break;
Documentation.focusSearchBar();
return false;
}
}
});
}
};
// quick alias for translations
_ = Documentation.gettext;
$(document).ready(function() {
Documentation.init();
});

14
_static/documentation_options.js Normal file
View File

@ -0,0 +1,14 @@
var DOCUMENTATION_OPTIONS = {
URL_ROOT: document.getElementById("documentation_options").getAttribute('data-url_root'),
VERSION: '1.0',
LANGUAGE: 'zh_CN',
COLLAPSE_INDEX: false,
BUILDER: 'html',
FILE_SUFFIX: '.html',
LINK_SUFFIX: '.html',
HAS_SOURCE: true,
SOURCELINK_SUFFIX: '.txt',
NAVIGATION_WITH_KEYS: false,
SHOW_SEARCH_SUMMARY: true,
ENABLE_SEARCH_SHORTCUTS: true,
};

BIN
_static/file.png Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 286 B

10872
_static/jquery-3.5.1.js vendored Normal file
View File

File diff suppressed because it is too large Load Diff

2
_static/jquery.js vendored Normal file
View File

File diff suppressed because one or more lines are too long

1
_static/js/badge_only.js Normal file
View File

@ -0,0 +1 @@
!function(e){var t={};function r(n){if(t[n])return t[n].exports;var o=t[n]={i:n,l:!1,exports:{}};return e[n].call(o.exports,o,o.exports,r),o.l=!0,o.exports}r.m=e,r.c=t,r.d=function(e,t,n){r.o(e,t)||Object.defineProperty(e,t,{enumerable:!0,get:n})},r.r=function(e){"undefined"!=typeof Symbol&&Symbol.toStringTag&&Object.defineProperty(e,Symbol.toStringTag,{value:"Module"}),Object.defineProperty(e,"__esModule",{value:!0})},r.t=function(e,t){if(1&t&&(e=r(e)),8&t)return e;if(4&t&&"object"==typeof e&&e&&e.__esModule)return e;var n=Object.create(null);if(r.r(n),Object.defineProperty(n,"default",{enumerable:!0,value:e}),2&t&&"string"!=typeof e)for(var o in e)r.d(n,o,function(t){return e[t]}.bind(null,o));return n},r.n=function(e){var t=e&&e.__esModule?function(){return e.default}:function(){return e};return r.d(t,"a",t),t},r.o=function(e,t){return Object.prototype.hasOwnProperty.call(e,t)},r.p="",r(r.s=4)}({4:function(e,t,r){}});

4
_static/js/html5shiv-printshiv.min.js vendored Normal file
View File

@ -0,0 +1,4 @@
/**
* @preserve HTML5 Shiv 3.7.3-pre | @afarkas @jdalton @jon_neal @rem | MIT/GPL2 Licensed
*/
!function(a,b){function c(a,b){var c=a.createElement("p"),d=a.getElementsByTagName("head")[0]||a.documentElement;return c.innerHTML="x<style>"+b+"</style>",d.insertBefore(c.lastChild,d.firstChild)}function d(){var a=y.elements;return"string"==typeof a?a.split(" "):a}function e(a,b){var c=y.elements;"string"!=typeof c&&(c=c.join(" ")),"string"!=typeof a&&(a=a.join(" ")),y.elements=c+" "+a,j(b)}function f(a){var b=x[a[v]];return b||(b={},w++,a[v]=w,x[w]=b),b}function g(a,c,d){if(c||(c=b),q)return c.createElement(a);d||(d=f(c));var e;return e=d.cache[a]?d.cache[a].cloneNode():u.test(a)?(d.cache[a]=d.createElem(a)).cloneNode():d.createElem(a),!e.canHaveChildren||t.test(a)||e.tagUrn?e:d.frag.appendChild(e)}function h(a,c){if(a||(a=b),q)return a.createDocumentFragment();c=c||f(a);for(var e=c.frag.cloneNode(),g=0,h=d(),i=h.length;i>g;g++)e.createElement(h[g]);return e}function i(a,b){b.cache||(b.cache={},b.createElem=a.createElement,b.createFrag=a.createDocumentFragment,b.frag=b.createFrag()),a.createElement=function(c){return y.shivMethods?g(c,a,b):b.createElem(c)},a.createDocumentFragment=Function("h,f","return function(){var n=f.cloneNode(),c=n.createElement;h.shivMethods&&("+d().join().replace(/[\w\-:]+/g,function(a){return b.createElem(a),b.frag.createElement(a),'c("'+a+'")'})+");return n}")(y,b.frag)}function j(a){a||(a=b);var d=f(a);return!y.shivCSS||p||d.hasCSS||(d.hasCSS=!!c(a,"article,aside,dialog,figcaption,figure,footer,header,hgroup,main,nav,section{display:block}mark{background:#FF0;color:#000}template{display:none}")),q||i(a,d),a}function k(a){for(var b,c=a.getElementsByTagName("*"),e=c.length,f=RegExp("^(?:"+d().join("|")+")$","i"),g=[];e--;)b=c[e],f.test(b.nodeName)&&g.push(b.applyElement(l(b)));return g}function l(a){for(var b,c=a.attributes,d=c.length,e=a.ownerDocument.createElement(A+":"+a.nodeName);d--;)b=c[d],b.specified&&e.setAttribute(b.nodeName,b.nodeValue);return e.style.cssText=a.style.cssText,e}function m(a){for(var b,c=a.split("{"),e=c.length,f=RegExp("(^|[\\s,>+~])("+d().join("|")+")(?=[[\\s,>+~#.:]|$)","gi"),g="$1"+A+"\\:$2";e--;)b=c[e]=c[e].split("}"),b[b.length-1]=b[b.length-1].replace(f,g),c[e]=b.join("}");return c.join("{")}function n(a){for(var b=a.length;b--;)a[b].removeNode()}function o(a){function b(){clearTimeout(g._removeSheetTimer),d&&d.removeNode(!0),d=null}var d,e,g=f(a),h=a.namespaces,i=a.parentWindow;return!B||a.printShived?a:("undefined"==typeof h[A]&&h.add(A),i.attachEvent("onbeforeprint",function(){b();for(var f,g,h,i=a.styleSheets,j=[],l=i.length,n=Array(l);l--;)n[l]=i[l];for(;h=n.pop();)if(!h.disabled&&z.test(h.media)){try{f=h.imports,g=f.length}catch(o){g=0}for(l=0;g>l;l++)n.push(f[l]);try{j.push(h.cssText)}catch(o){}}j=m(j.reverse().join("")),e=k(a),d=c(a,j)}),i.attachEvent("onafterprint",function(){n(e),clearTimeout(g._removeSheetTimer),g._removeSheetTimer=setTimeout(b,500)}),a.printShived=!0,a)}var p,q,r="3.7.3",s=a.html5||{},t=/^<|^(?:button|map|select|textarea|object|iframe|option|optgroup)$/i,u=/^(?:a|b|code|div|fieldset|h1|h2|h3|h4|h5|h6|i|label|li|ol|p|q|span|strong|style|table|tbody|td|th|tr|ul)$/i,v="_html5shiv",w=0,x={};!function(){try{var a=b.createElement("a");a.innerHTML="<xyz></xyz>",p="hidden"in a,q=1==a.childNodes.length||function(){b.createElement("a");var a=b.createDocumentFragment();return"undefined"==typeof a.cloneNode||"undefined"==typeof a.createDocumentFragment||"undefined"==typeof a.createElement}()}catch(c){p=!0,q=!0}}();var y={elements:s.elements||"abbr article aside audio bdi canvas data datalist details dialog figcaption figure footer header hgroup main mark meter nav output picture progress section summary template time video",version:r,shivCSS:s.shivCSS!==!1,supportsUnknownElements:q,shivMethods:s.shivMethods!==!1,type:"default",shivDocument:j,createElement:g,createDocumentFragment:h,addElements:e};a.html5=y,j(b);var z=/^$|\b(?:all|print)\b/,A="html5shiv",B=!q&&function(){var c=b.documentElement;return!("undefined"==typeof b.namespaces||"undefined"==typeof b.parentWindow||"undefined"==typeof c.applyElement||"undefined"==typeof c.removeNode||"undefined"==typeof a.attachEvent)}();y.type+=" print",y.shivPrint=o,o(b),"object"==typeof module&&module.exports&&(module.exports=y)}("undefined"!=typeof window?window:this,document);

4
_static/js/html5shiv.min.js vendored Normal file
View File

@ -0,0 +1,4 @@
/**
* @preserve HTML5 Shiv 3.7.3 | @afarkas @jdalton @jon_neal @rem | MIT/GPL2 Licensed
*/
!function(a,b){function c(a,b){var c=a.createElement("p"),d=a.getElementsByTagName("head")[0]||a.documentElement;return c.innerHTML="x<style>"+b+"</style>",d.insertBefore(c.lastChild,d.firstChild)}function d(){var a=t.elements;return"string"==typeof a?a.split(" "):a}function e(a,b){var c=t.elements;"string"!=typeof c&&(c=c.join(" ")),"string"!=typeof a&&(a=a.join(" ")),t.elements=c+" "+a,j(b)}function f(a){var b=s[a[q]];return b||(b={},r++,a[q]=r,s[r]=b),b}function g(a,c,d){if(c||(c=b),l)return c.createElement(a);d||(d=f(c));var e;return e=d.cache[a]?d.cache[a].cloneNode():p.test(a)?(d.cache[a]=d.createElem(a)).cloneNode():d.createElem(a),!e.canHaveChildren||o.test(a)||e.tagUrn?e:d.frag.appendChild(e)}function h(a,c){if(a||(a=b),l)return a.createDocumentFragment();c=c||f(a);for(var e=c.frag.cloneNode(),g=0,h=d(),i=h.length;i>g;g++)e.createElement(h[g]);return e}function i(a,b){b.cache||(b.cache={},b.createElem=a.createElement,b.createFrag=a.createDocumentFragment,b.frag=b.createFrag()),a.createElement=function(c){return t.shivMethods?g(c,a,b):b.createElem(c)},a.createDocumentFragment=Function("h,f","return function(){var n=f.cloneNode(),c=n.createElement;h.shivMethods&&("+d().join().replace(/[\w\-:]+/g,function(a){return b.createElem(a),b.frag.createElement(a),'c("'+a+'")'})+");return n}")(t,b.frag)}function j(a){a||(a=b);var d=f(a);return!t.shivCSS||k||d.hasCSS||(d.hasCSS=!!c(a,"article,aside,dialog,figcaption,figure,footer,header,hgroup,main,nav,section{display:block}mark{background:#FF0;color:#000}template{display:none}")),l||i(a,d),a}var k,l,m="3.7.3-pre",n=a.html5||{},o=/^<|^(?:button|map|select|textarea|object|iframe|option|optgroup)$/i,p=/^(?:a|b|code|div|fieldset|h1|h2|h3|h4|h5|h6|i|label|li|ol|p|q|span|strong|style|table|tbody|td|th|tr|ul)$/i,q="_html5shiv",r=0,s={};!function(){try{var a=b.createElement("a");a.innerHTML="<xyz></xyz>",k="hidden"in a,l=1==a.childNodes.length||function(){b.createElement("a");var a=b.createDocumentFragment();return"undefined"==typeof a.cloneNode||"undefined"==typeof a.createDocumentFragment||"undefined"==typeof a.createElement}()}catch(c){k=!0,l=!0}}();var t={elements:n.elements||"abbr article aside audio bdi canvas data datalist details dialog figcaption figure footer header hgroup main mark meter nav output picture progress section summary template time video",version:m,shivCSS:n.shivCSS!==!1,supportsUnknownElements:l,shivMethods:n.shivMethods!==!1,type:"default",shivDocument:j,createElement:g,createDocumentFragment:h,addElements:e};a.html5=t,j(b),"object"==typeof module&&module.exports&&(module.exports=t)}("undefined"!=typeof window?window:this,document);

1
_static/js/theme.js Normal file
View File

File diff suppressed because one or more lines are too long

297
_static/language_data.js Normal file
View File

@ -0,0 +1,297 @@
/*
* language_data.js
* ~~~~~~~~~~~~~~~~
*
* This script contains the language-specific data used by searchtools.js,
* namely the list of stopwords, stemmer, scorer and splitter.
*
* :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
* :license: BSD, see LICENSE for details.
*
*/
var stopwords = ["a","and","are","as","at","be","but","by","for","if","in","into","is","it","near","no","not","of","on","or","such","that","the","their","then","there","these","they","this","to","was","will","with"];
/* Non-minified version is copied as a separate JS file, is available */
/**
* Porter Stemmer
*/
var Stemmer = function() {
var step2list = {
ational: 'ate',
tional: 'tion',
enci: 'ence',
anci: 'ance',
izer: 'ize',
bli: 'ble',
alli: 'al',
entli: 'ent',
eli: 'e',
ousli: 'ous',
ization: 'ize',
ation: 'ate',
ator: 'ate',
alism: 'al',
iveness: 'ive',
fulness: 'ful',
ousness: 'ous',
aliti: 'al',
iviti: 'ive',
biliti: 'ble',
logi: 'log'
};
var step3list = {
icate: 'ic',
ative: '',
alize: 'al',
iciti: 'ic',
ical: 'ic',
ful: '',
ness: ''
};
var c = "[^aeiou]"; // consonant
var v = "[aeiouy]"; // vowel
var C = c + "[^aeiouy]*"; // consonant sequence
var V = v + "[aeiou]*"; // vowel sequence
var mgr0 = "^(" + C + ")?" + V + C; // [C]VC... is m>0
var meq1 = "^(" + C + ")?" + V + C + "(" + V + ")?$"; // [C]VC[V] is m=1
var mgr1 = "^(" + C + ")?" + V + C + V + C; // [C]VCVC... is m>1
var s_v = "^(" + C + ")?" + v; // vowel in stem
this.stemWord = function (w) {
var stem;
var suffix;
var firstch;
var origword = w;
if (w.length < 3)
return w;
var re;
var re2;
var re3;
var re4;
firstch = w.substr(0,1);
if (firstch == "y")
w = firstch.toUpperCase() + w.substr(1);
// Step 1a
re = /^(.+?)(ss|i)es$/;
re2 = /^(.+?)([^s])s$/;
if (re.test(w))
w = w.replace(re,"$1$2");
else if (re2.test(w))
w = w.replace(re2,"$1$2");
// Step 1b
re = /^(.+?)eed$/;
re2 = /^(.+?)(ed|ing)$/;
if (re.test(w)) {
var fp = re.exec(w);
re = new RegExp(mgr0);
if (re.test(fp[1])) {
re = /.$/;
w = w.replace(re,"");
}
}
else if (re2.test(w)) {
var fp = re2.exec(w);
stem = fp[1];
re2 = new RegExp(s_v);
if (re2.test(stem)) {
w = stem;
re2 = /(at|bl|iz)$/;
re3 = new RegExp("([^aeiouylsz])\\1$");
re4 = new RegExp("^" + C + v + "[^aeiouwxy]$");
if (re2.test(w))
w = w + "e";
else if (re3.test(w)) {
re = /.$/;
w = w.replace(re,"");
}
else if (re4.test(w))
w = w + "e";
}
}
// Step 1c
re = /^(.+?)y$/;
if (re.test(w)) {
var fp = re.exec(w);
stem = fp[1];
re = new RegExp(s_v);
if (re.test(stem))
w = stem + "i";
}
// Step 2
re = /^(.+?)(ational|tional|enci|anci|izer|bli|alli|entli|eli|ousli|ization|ation|ator|alism|iveness|fulness|ousness|aliti|iviti|biliti|logi)$/;
if (re.test(w)) {
var fp = re.exec(w);
stem = fp[1];
suffix = fp[2];
re = new RegExp(mgr0);
if (re.test(stem))
w = stem + step2list[suffix];
}
// Step 3
re = /^(.+?)(icate|ative|alize|iciti|ical|ful|ness)$/;
if (re.test(w)) {
var fp = re.exec(w);
stem = fp[1];
suffix = fp[2];
re = new RegExp(mgr0);
if (re.test(stem))
w = stem + step3list[suffix];
}
// Step 4
re = /^(.+?)(al|ance|ence|er|ic|able|ible|ant|ement|ment|ent|ou|ism|ate|iti|ous|ive|ize)$/;
re2 = /^(.+?)(s|t)(ion)$/;
if (re.test(w)) {
var fp = re.exec(w);
stem = fp[1];
re = new RegExp(mgr1);
if (re.test(stem))
w = stem;
}
else if (re2.test(w)) {
var fp = re2.exec(w);
stem = fp[1] + fp[2];
re2 = new RegExp(mgr1);
if (re2.test(stem))
w = stem;
}
// Step 5
re = /^(.+?)e$/;
if (re.test(w)) {
var fp = re.exec(w);
stem = fp[1];
re = new RegExp(mgr1);
re2 = new RegExp(meq1);
re3 = new RegExp("^" + C + v + "[^aeiouwxy]$");
if (re.test(stem) || (re2.test(stem) && !(re3.test(stem))))
w = stem;
}
re = /ll$/;
re2 = new RegExp(mgr1);
if (re.test(w) && re2.test(w)) {
re = /.$/;
w = w.replace(re,"");
}
// and turn initial Y back to y
if (firstch == "y")
w = firstch.toLowerCase() + w.substr(1);
return w;
}
}
var splitChars = (function() {
var result = {};
var singles = [96, 180, 187, 191, 215, 247, 749, 885, 903, 907, 909, 930, 1014, 1648,
1748, 1809, 2416, 2473, 2481, 2526, 2601, 2609, 2612, 2615, 2653, 2702,
2706, 2729, 2737, 2740, 2857, 2865, 2868, 2910, 2928, 2948, 2961, 2971,
2973, 3085, 3089, 3113, 3124, 3213, 3217, 3241, 3252, 3295, 3341, 3345,
3369, 3506, 3516, 3633, 3715, 3721, 3736, 3744, 3748, 3750, 3756, 3761,
3781, 3912, 4239, 4347, 4681, 4695, 4697, 4745, 4785, 4799, 4801, 4823,
4881, 5760, 5901, 5997, 6313, 7405, 8024, 8026, 8028, 8030, 8117, 8125,
8133, 8181, 8468, 8485, 8487, 8489, 8494, 8527, 11311, 11359, 11687, 11695,
11703, 11711, 11719, 11727, 11735, 12448, 12539, 43010, 43014, 43019, 43587,
43696, 43713, 64286, 64297, 64311, 64317, 64319, 64322, 64325, 65141];
var i, j, start, end;
for (i = 0; i < singles.length; i++) {
result[singles[i]] = true;
}
var ranges = [[0, 47], [58, 64], [91, 94], [123, 169], [171, 177], [182, 184], [706, 709],
[722, 735], [741, 747], [751, 879], [888, 889], [894, 901], [1154, 1161],
[1318, 1328], [1367, 1368], [1370, 1376], [1416, 1487], [1515, 1519], [1523, 1568],
[1611, 1631], [1642, 1645], [1750, 1764], [1767, 1773], [1789, 1790], [1792, 1807],
[1840, 1868], [1958, 1968], [1970, 1983], [2027, 2035], [2038, 2041], [2043, 2047],
[2070, 2073], [2075, 2083], [2085, 2087], [2089, 2307], [2362, 2364], [2366, 2383],
[2385, 2391], [2402, 2405], [2419, 2424], [2432, 2436], [2445, 2446], [2449, 2450],
[2483, 2485], [2490, 2492], [2494, 2509], [2511, 2523], [2530, 2533], [2546, 2547],
[2554, 2564], [2571, 2574], [2577, 2578], [2618, 2648], [2655, 2661], [2672, 2673],
[2677, 2692], [2746, 2748], [2750, 2767], [2769, 2783], [2786, 2789], [2800, 2820],
[2829, 2830], [2833, 2834], [2874, 2876], [2878, 2907], [2914, 2917], [2930, 2946],
[2955, 2957], [2966, 2968], [2976, 2978], [2981, 2983], [2987, 2989], [3002, 3023],
[3025, 3045], [3059, 3076], [3130, 3132], [3134, 3159], [3162, 3167], [3170, 3173],
[3184, 3191], [3199, 3204], [3258, 3260], [3262, 3293], [3298, 3301], [3312, 3332],
[3386, 3388], [3390, 3423], [3426, 3429], [3446, 3449], [3456, 3460], [3479, 3481],
[3518, 3519], [3527, 3584], [3636, 3647], [3655, 3663], [3674, 3712], [3717, 3718],
[3723, 3724], [3726, 3731], [3752, 3753], [3764, 3772], [3774, 3775], [3783, 3791],
[3802, 3803], [3806, 3839], [3841, 3871], [3892, 3903], [3949, 3975], [3980, 4095],
[4139, 4158], [4170, 4175], [4182, 4185], [4190, 4192], [4194, 4196], [4199, 4205],
[4209, 4212], [4226, 4237], [4250, 4255], [4294, 4303], [4349, 4351], [4686, 4687],
[4702, 4703], [4750, 4751], [4790, 4791], [4806, 4807], [4886, 4887], [4955, 4968],
[4989, 4991], [5008, 5023], [5109, 5120], [5741, 5742], [5787, 5791], [5867, 5869],
[5873, 5887], [5906, 5919], [5938, 5951], [5970, 5983], [6001, 6015], [6068, 6102],
[6104, 6107], [6109, 6111], [6122, 6127], [6138, 6159], [6170, 6175], [6264, 6271],
[6315, 6319], [6390, 6399], [6429, 6469], [6510, 6511], [6517, 6527], [6572, 6592],
[6600, 6607], [6619, 6655], [6679, 6687], [6741, 6783], [6794, 6799], [6810, 6822],
[6824, 6916], [6964, 6980], [6988, 6991], [7002, 7042], [7073, 7085], [7098, 7167],
[7204, 7231], [7242, 7244], [7294, 7400], [7410, 7423], [7616, 7679], [7958, 7959],
[7966, 7967], [8006, 8007], [8014, 8015], [8062, 8063], [8127, 8129], [8141, 8143],
[8148, 8149], [8156, 8159], [8173, 8177], [8189, 8303], [8306, 8307], [8314, 8318],
[8330, 8335], [8341, 8449], [8451, 8454], [8456, 8457], [8470, 8472], [8478, 8483],
[8506, 8507], [8512, 8516], [8522, 8525], [8586, 9311], [9372, 9449], [9472, 10101],
[10132, 11263], [11493, 11498], [11503, 11516], [11518, 11519], [11558, 11567],
[11622, 11630], [11632, 11647], [11671, 11679], [11743, 11822], [11824, 12292],
[12296, 12320], [12330, 12336], [12342, 12343], [12349, 12352], [12439, 12444],
[12544, 12548], [12590, 12592], [12687, 12689], [12694, 12703], [12728, 12783],
[12800, 12831], [12842, 12880], [12896, 12927], [12938, 12976], [12992, 13311],
[19894, 19967], [40908, 40959], [42125, 42191], [42238, 42239], [42509, 42511],
[42540, 42559], [42592, 42593], [42607, 42622], [42648, 42655], [42736, 42774],
[42784, 42785], [42889, 42890], [42893, 43002], [43043, 43055], [43062, 43071],
[43124, 43137], [43188, 43215], [43226, 43249], [43256, 43258], [43260, 43263],
[43302, 43311], [43335, 43359], [43389, 43395], [43443, 43470], [43482, 43519],
[43561, 43583], [43596, 43599], [43610, 43615], [43639, 43641], [43643, 43647],
[43698, 43700], [43703, 43704], [43710, 43711], [43715, 43738], [43742, 43967],
[44003, 44015], [44026, 44031], [55204, 55215], [55239, 55242], [55292, 55295],
[57344, 63743], [64046, 64047], [64110, 64111], [64218, 64255], [64263, 64274],
[64280, 64284], [64434, 64466], [64830, 64847], [64912, 64913], [64968, 65007],
[65020, 65135], [65277, 65295], [65306, 65312], [65339, 65344], [65371, 65381],
[65471, 65473], [65480, 65481], [65488, 65489], [65496, 65497]];
for (i = 0; i < ranges.length; i++) {
start = ranges[i][0];
end = ranges[i][1];
for (j = start; j <= end; j++) {
result[j] = true;
}
}
return result;
})();
function splitQuery(query) {
var result = [];
var start = -1;
for (var i = 0; i < query.length; i++) {
if (splitChars[query.charCodeAt(i)]) {
if (start !== -1) {
result.push(query.slice(start, i));
start = -1;
}
} else if (start === -1) {
start = i;
}
}
if (start !== -1) {
result.push(query.slice(start));
}
return result;
}

BIN
_static/minus.png Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 90 B

BIN
_static/plus.png Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 90 B

74
_static/pygments.css Normal file
View File

@ -0,0 +1,74 @@
pre { line-height: 125%; }
td.linenos .normal { color: inherit; background-color: transparent; padding-left: 5px; padding-right: 5px; }
span.linenos { color: inherit; background-color: transparent; padding-left: 5px; padding-right: 5px; }
td.linenos .special { color: #000000; background-color: #ffffc0; padding-left: 5px; padding-right: 5px; }
span.linenos.special { color: #000000; background-color: #ffffc0; padding-left: 5px; padding-right: 5px; }
.highlight .hll { background-color: #ffffcc }
.highlight { background: #eeffcc; }
.highlight .c { color: #408090; font-style: italic } /* Comment */
.highlight .err { border: 1px solid #FF0000 } /* Error */
.highlight .k { color: #007020; font-weight: bold } /* Keyword */
.highlight .o { color: #666666 } /* Operator */
.highlight .ch { color: #408090; font-style: italic } /* Comment.Hashbang */
.highlight .cm { color: #408090; font-style: italic } /* Comment.Multiline */
.highlight .cp { color: #007020 } /* Comment.Preproc */
.highlight .cpf { color: #408090; font-style: italic } /* Comment.PreprocFile */
.highlight .c1 { color: #408090; font-style: italic } /* Comment.Single */
.highlight .cs { color: #408090; background-color: #fff0f0 } /* Comment.Special */
.highlight .gd { color: #A00000 } /* Generic.Deleted */
.highlight .ge { font-style: italic } /* Generic.Emph */
.highlight .gr { color: #FF0000 } /* Generic.Error */
.highlight .gh { color: #000080; font-weight: bold } /* Generic.Heading */
.highlight .gi { color: #00A000 } /* Generic.Inserted */
.highlight .go { color: #333333 } /* Generic.Output */
.highlight .gp { color: #c65d09; font-weight: bold } /* Generic.Prompt */
.highlight .gs { font-weight: bold } /* Generic.Strong */
.highlight .gu { color: #800080; font-weight: bold } /* Generic.Subheading */
.highlight .gt { color: #0044DD } /* Generic.Traceback */
.highlight .kc { color: #007020; font-weight: bold } /* Keyword.Constant */
.highlight .kd { color: #007020; font-weight: bold } /* Keyword.Declaration */
.highlight .kn { color: #007020; font-weight: bold } /* Keyword.Namespace */
.highlight .kp { color: #007020 } /* Keyword.Pseudo */
.highlight .kr { color: #007020; font-weight: bold } /* Keyword.Reserved */
.highlight .kt { color: #902000 } /* Keyword.Type */
.highlight .m { color: #208050 } /* Literal.Number */
.highlight .s { color: #4070a0 } /* Literal.String */
.highlight .na { color: #4070a0 } /* Name.Attribute */
.highlight .nb { color: #007020 } /* Name.Builtin */
.highlight .nc { color: #0e84b5; font-weight: bold } /* Name.Class */
.highlight .no { color: #60add5 } /* Name.Constant */
.highlight .nd { color: #555555; font-weight: bold } /* Name.Decorator */
.highlight .ni { color: #d55537; font-weight: bold } /* Name.Entity */
.highlight .ne { color: #007020 } /* Name.Exception */
.highlight .nf { color: #06287e } /* Name.Function */
.highlight .nl { color: #002070; font-weight: bold } /* Name.Label */
.highlight .nn { color: #0e84b5; font-weight: bold } /* Name.Namespace */
.highlight .nt { color: #062873; font-weight: bold } /* Name.Tag */
.highlight .nv { color: #bb60d5 } /* Name.Variable */
.highlight .ow { color: #007020; font-weight: bold } /* Operator.Word */
.highlight .w { color: #bbbbbb } /* Text.Whitespace */
.highlight .mb { color: #208050 } /* Literal.Number.Bin */
.highlight .mf { color: #208050 } /* Literal.Number.Float */
.highlight .mh { color: #208050 } /* Literal.Number.Hex */
.highlight .mi { color: #208050 } /* Literal.Number.Integer */
.highlight .mo { color: #208050 } /* Literal.Number.Oct */
.highlight .sa { color: #4070a0 } /* Literal.String.Affix */
.highlight .sb { color: #4070a0 } /* Literal.String.Backtick */
.highlight .sc { color: #4070a0 } /* Literal.String.Char */
.highlight .dl { color: #4070a0 } /* Literal.String.Delimiter */
.highlight .sd { color: #4070a0; font-style: italic } /* Literal.String.Doc */
.highlight .s2 { color: #4070a0 } /* Literal.String.Double */
.highlight .se { color: #4070a0; font-weight: bold } /* Literal.String.Escape */
.highlight .sh { color: #4070a0 } /* Literal.String.Heredoc */
.highlight .si { color: #70a0d0; font-style: italic } /* Literal.String.Interpol */
.highlight .sx { color: #c65d09 } /* Literal.String.Other */
.highlight .sr { color: #235388 } /* Literal.String.Regex */
.highlight .s1 { color: #4070a0 } /* Literal.String.Single */
.highlight .ss { color: #517918 } /* Literal.String.Symbol */
.highlight .bp { color: #007020 } /* Name.Builtin.Pseudo */
.highlight .fm { color: #06287e } /* Name.Function.Magic */
.highlight .vc { color: #bb60d5 } /* Name.Variable.Class */
.highlight .vg { color: #bb60d5 } /* Name.Variable.Global */
.highlight .vi { color: #bb60d5 } /* Name.Variable.Instance */
.highlight .vm { color: #bb60d5 } /* Name.Variable.Magic */
.highlight .il { color: #208050 } /* Literal.Number.Integer.Long */

525
_static/searchtools.js Normal file
View File

@ -0,0 +1,525 @@
/*
* searchtools.js
* ~~~~~~~~~~~~~~~~
*
* Sphinx JavaScript utilities for the full-text search.
*
* :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
* :license: BSD, see LICENSE for details.
*
*/
if (!Scorer) {
/**
* Simple result scoring code.
*/
var Scorer = {
// Implement the following function to further tweak the score for each result
// The function takes a result array [filename, title, anchor, descr, score]
// and returns the new score.
/*
score: function(result) {
return result[4];
},
*/
// query matches the full name of an object
objNameMatch: 11,
// or matches in the last dotted part of the object name
objPartialMatch: 6,
// Additive scores depending on the priority of the object
objPrio: {0: 15, // used to be importantResults
1: 5, // used to be objectResults
2: -5}, // used to be unimportantResults
// Used when the priority is not in the mapping.
objPrioDefault: 0,
// query found in title
title: 15,
partialTitle: 7,
// query found in terms
term: 5,
partialTerm: 2
};
}
if (!splitQuery) {
function splitQuery(query) {
return query.split(/\s+/);
}
}
/**
* Search Module
*/
var Search = {
_index : null,
_queued_query : null,
_pulse_status : -1,
htmlToText : function(htmlString) {
var virtualDocument = document.implementation.createHTMLDocument('virtual');
var htmlElement = $(htmlString, virtualDocument);
htmlElement.find('.headerlink').remove();
docContent = htmlElement.find('[role=main]')[0];
if(docContent === undefined) {
console.warn("Content block not found. Sphinx search tries to obtain it " +
"via '[role=main]'. Could you check your theme or template.");
return "";
}
return docContent.textContent || docContent.innerText;
},
init : function() {
var params = $.getQueryParameters();
if (params.q) {
var query = params.q[0];
$('input[name="q"]')[0].value = query;
this.performSearch(query);
}
},
loadIndex : function(url) {
$.ajax({type: "GET", url: url, data: null,
dataType: "script", cache: true,
complete: function(jqxhr, textstatus) {
if (textstatus != "success") {
document.getElementById("searchindexloader").src = url;
}
}});
},
setIndex : function(index) {
var q;
this._index = index;
if ((q = this._queued_query) !== null) {
this._queued_query = null;
Search.query(q);
}
},
hasIndex : function() {
return this._index !== null;
},
deferQuery : function(query) {
this._queued_query = query;
},
stopPulse : function() {
this._pulse_status = 0;
},
startPulse : function() {
if (this._pulse_status >= 0)
return;
function pulse() {
var i;
Search._pulse_status = (Search._pulse_status + 1) % 4;
var dotString = '';
for (i = 0; i < Search._pulse_status; i++)
dotString += '.';
Search.dots.text(dotString);
if (Search._pulse_status > -1)
window.setTimeout(pulse, 500);
}
pulse();
},
/**
* perform a search for something (or wait until index is loaded)
*/
performSearch : function(query) {
// create the required interface elements
this.out = $('#search-results');
this.title = $('<h2>' + _('Searching') + '</h2>').appendTo(this.out);
this.dots = $('<span></span>').appendTo(this.title);
this.status = $('<p class="search-summary">&nbsp;</p>').appendTo(this.out);
this.output = $('<ul class="search"/>').appendTo(this.out);
$('#search-progress').text(_('Preparing search...'));
this.startPulse();
// index already loaded, the browser was quick!
if (this.hasIndex())
this.query(query);
else
this.deferQuery(query);
},
/**
* execute search (requires search index to be loaded)
*/
query : function(query) {
var i;
// stem the searchterms and add them to the correct list
var stemmer = new Stemmer();
var searchterms = [];
var excluded = [];
var hlterms = [];
var tmp = splitQuery(query);
var objectterms = [];
for (i = 0; i < tmp.length; i++) {
if (tmp[i] !== "") {
objectterms.push(tmp[i].toLowerCase());
}
if ($u.indexOf(stopwords, tmp[i].toLowerCase()) != -1 || tmp[i] === "") {
// skip this "word"
continue;
}
// stem the word
var word = stemmer.stemWord(tmp[i].toLowerCase());
var toAppend;
// select the correct list
if (word[0] == '-') {
toAppend = excluded;
word = word.substr(1);
}
else {
toAppend = searchterms;
hlterms.push(tmp[i].toLowerCase());
}
// only add if not already in the list
if (!$u.contains(toAppend, word))
toAppend.push(word);
}
var highlightstring = '?highlight=' + $.urlencode(hlterms.join(" "));
// console.debug('SEARCH: searching for:');
// console.info('required: ', searchterms);
// console.info('excluded: ', excluded);
// prepare search
var terms = this._index.terms;
var titleterms = this._index.titleterms;
// array of [filename, title, anchor, descr, score]
var results = [];
$('#search-progress').empty();
// lookup as object
for (i = 0; i < objectterms.length; i++) {
var others = [].concat(objectterms.slice(0, i),
objectterms.slice(i+1, objectterms.length));
results = results.concat(this.performObjectSearch(objectterms[i], others));
}
// lookup as search terms in fulltext
results = results.concat(this.performTermsSearch(searchterms, excluded, terms, titleterms));
// let the scorer override scores with a custom scoring function
if (Scorer.score) {
for (i = 0; i < results.length; i++)
results[i][4] = Scorer.score(results[i]);
}
// now sort the results by score (in opposite order of appearance, since the
// display function below uses pop() to retrieve items) and then
// alphabetically
results.sort(function(a, b) {
var left = a[4];
var right = b[4];
if (left > right) {
return 1;
} else if (left < right) {
return -1;
} else {
// same score: sort alphabetically
left = a[1].toLowerCase();
right = b[1].toLowerCase();
return (left > right) ? -1 : ((left < right) ? 1 : 0);
}
});
// for debugging
//Search.lastresults = results.slice(); // a copy
//console.info('search results:', Search.lastresults);
// print the results
var resultCount = results.length;
function displayNextItem() {
// results left, load the summary and display it
if (results.length) {
var item = results.pop();
var listItem = $('<li></li>');
var requestUrl = "";
var linkUrl = "";
if (DOCUMENTATION_OPTIONS.BUILDER === 'dirhtml') {
// dirhtml builder
var dirname = item[0] + '/';
if (dirname.match(/\/index\/$/)) {
dirname = dirname.substring(0, dirname.length-6);
} else if (dirname == 'index/') {
dirname = '';
}
requestUrl = DOCUMENTATION_OPTIONS.URL_ROOT + dirname;
linkUrl = requestUrl;
} else {
// normal html builders
requestUrl = DOCUMENTATION_OPTIONS.URL_ROOT + item[0] + DOCUMENTATION_OPTIONS.FILE_SUFFIX;
linkUrl = item[0] + DOCUMENTATION_OPTIONS.LINK_SUFFIX;
}
listItem.append($('<a/>').attr('href',
linkUrl +
highlightstring + item[2]).html(item[1]));
if (item[3]) {
listItem.append($('<span> (' + item[3] + ')</span>'));
Search.output.append(listItem);
setTimeout(function() {
displayNextItem();
}, 5);
} else if (DOCUMENTATION_OPTIONS.SHOW_SEARCH_SUMMARY) {
$.ajax({url: requestUrl,
dataType: "text",
complete: function(jqxhr, textstatus) {
var data = jqxhr.responseText;
if (data !== '' && data !== undefined) {
var summary = Search.makeSearchSummary(data, searchterms, hlterms);
if (summary) {
listItem.append(summary);
}
}
Search.output.append(listItem);
setTimeout(function() {
displayNextItem();
}, 5);
}});
} else {
// just display title
Search.output.append(listItem);
setTimeout(function() {
displayNextItem();
}, 5);
}
}
// search finished, update title and status message
else {
Search.stopPulse();
Search.title.text(_('Search Results'));
if (!resultCount)
Search.status.text(_('Your search did not match any documents. Please make sure that all words are spelled correctly and that you\'ve selected enough categories.'));
else
Search.status.text(_('Search finished, found %s page(s) matching the search query.').replace('%s', resultCount));
Search.status.fadeIn(500);
}
}
displayNextItem();
},
/**
* search for object names
*/
performObjectSearch : function(object, otherterms) {
var filenames = this._index.filenames;
var docnames = this._index.docnames;
var objects = this._index.objects;
var objnames = this._index.objnames;
var titles = this._index.titles;
var i;
var results = [];
for (var prefix in objects) {
for (var iMatch = 0; iMatch != objects[prefix].length; ++iMatch) {
var match = objects[prefix][iMatch];
var name = match[4];
var fullname = (prefix ? prefix + '.' : '') + name;
var fullnameLower = fullname.toLowerCase()
if (fullnameLower.indexOf(object) > -1) {
var score = 0;
var parts = fullnameLower.split('.');
// check for different match types: exact matches of full name or
// "last name" (i.e. last dotted part)
if (fullnameLower == object || parts[parts.length - 1] == object) {
score += Scorer.objNameMatch;
// matches in last name
} else if (parts[parts.length - 1].indexOf(object) > -1) {
score += Scorer.objPartialMatch;
}
var objname = objnames[match[1]][2];
var title = titles[match[0]];
// If more than one term searched for, we require other words to be
// found in the name/title/description
if (otherterms.length > 0) {
var haystack = (prefix + ' ' + name + ' ' +
objname + ' ' + title).toLowerCase();
var allfound = true;
for (i = 0; i < otherterms.length; i++) {
if (haystack.indexOf(otherterms[i]) == -1) {
allfound = false;
break;
}
}
if (!allfound) {
continue;
}
}
var descr = objname + _(', in ') + title;
var anchor = match[3];
if (anchor === '')
anchor = fullname;
else if (anchor == '-')
anchor = objnames[match[1]][1] + '-' + fullname;
// add custom score for some objects according to scorer
if (Scorer.objPrio.hasOwnProperty(match[2])) {
score += Scorer.objPrio[match[2]];
} else {
score += Scorer.objPrioDefault;
}
results.push([docnames[match[0]], fullname, '#'+anchor, descr, score, filenames[match[0]]]);
}
}
}
return results;
},
/**
* See https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Regular_Expressions
*/
escapeRegExp : function(string) {
return string.replace(/[.*+\-?^${}()|[\]\\]/g, '\\$&'); // $& means the whole matched string
},
/**
* search for full-text terms in the index
*/
performTermsSearch : function(searchterms, excluded, terms, titleterms) {
var docnames = this._index.docnames;
var filenames = this._index.filenames;
var titles = this._index.titles;
var i, j, file;
var fileMap = {};
var scoreMap = {};
var results = [];
// perform the search on the required terms
for (i = 0; i < searchterms.length; i++) {
var word = searchterms[i];
var files = [];
var _o = [
{files: terms[word], score: Scorer.term},
{files: titleterms[word], score: Scorer.title}
];
// add support for partial matches
if (word.length > 2) {
var word_regex = this.escapeRegExp(word);
for (var w in terms) {
if (w.match(word_regex) && !terms[word]) {
_o.push({files: terms[w], score: Scorer.partialTerm})
}
}
for (var w in titleterms) {
if (w.match(word_regex) && !titleterms[word]) {
_o.push({files: titleterms[w], score: Scorer.partialTitle})
}
}
}
// no match but word was a required one
if ($u.every(_o, function(o){return o.files === undefined;})) {
break;
}
// found search word in contents
$u.each(_o, function(o) {
var _files = o.files;
if (_files === undefined)
return
if (_files.length === undefined)
_files = [_files];
files = files.concat(_files);
// set score for the word in each file to Scorer.term
for (j = 0; j < _files.length; j++) {
file = _files[j];
if (!(file in scoreMap))
scoreMap[file] = {};
scoreMap[file][word] = o.score;
}
});
// create the mapping
for (j = 0; j < files.length; j++) {
file = files[j];
if (file in fileMap && fileMap[file].indexOf(word) === -1)
fileMap[file].push(word);
else
fileMap[file] = [word];
}
}
// now check if the files don't contain excluded terms
for (file in fileMap) {
var valid = true;
// check if all requirements are matched
var filteredTermCount = // as search terms with length < 3 are discarded: ignore
searchterms.filter(function(term){return term.length > 2}).length
if (
fileMap[file].length != searchterms.length &&
fileMap[file].length != filteredTermCount
) continue;
// ensure that none of the excluded terms is in the search result
for (i = 0; i < excluded.length; i++) {
if (terms[excluded[i]] == file ||
titleterms[excluded[i]] == file ||
$u.contains(terms[excluded[i]] || [], file) ||
$u.contains(titleterms[excluded[i]] || [], file)) {
valid = false;
break;
}
}
// if we have still a valid result we can add it to the result list
if (valid) {
// select one (max) score for the file.
// for better ranking, we should calculate ranking by using words statistics like basic tf-idf...
var score = $u.max($u.map(fileMap[file], function(w){return scoreMap[file][w]}));
results.push([docnames[file], titles[file], '', null, score, filenames[file]]);
}
}
return results;
},
/**
* helper function to return a node containing the
* search summary for a given text. keywords is a list
* of stemmed words, hlwords is the list of normal, unstemmed
* words. the first one is used to find the occurrence, the
* latter for highlighting it.
*/
makeSearchSummary : function(htmlText, keywords, hlwords) {
var text = Search.htmlToText(htmlText);
if (text == "") {
return null;
}
var textLower = text.toLowerCase();
var start = 0;
$.each(keywords, function() {
var i = textLower.indexOf(this.toLowerCase());
if (i > -1)
start = i;
});
start = Math.max(start - 120, 0);
var excerpt = ((start > 0) ? '...' : '') +
$.trim(text.substr(start, 240)) +
((start + 240 - text.length) ? '...' : '');
var rv = $('<p class="context"></p>').text(excerpt);
$.each(hlwords, function() {
rv = rv.highlightText(this, 'highlighted');
});
return rv;
}
};
$(document).ready(function() {
Search.init();
});

63
_static/translations.js Normal file
View File

@ -0,0 +1,63 @@
Documentation.addTranslations({
"locale": "zh_Hans_CN",
"messages": {
"%(filename)s &#8212; %(docstitle)s": "%(filename)s &#8212; %(docstitle)s",
"&#169; <a href=\"%(path)s\">Copyright</a> %(copyright)s.": "&#169; <a href=\"%(path)s\"> \u7248\u6743\u6240\u6709</a> %(copyright)s.",
"&#169; Copyright %(copyright)s.": "&#169; \u7248\u6743\u6240\u6709 %(copyright)s.",
", in ": "\uff0c \u5728 ",
"About these documents": "\u5173\u4e8e\u8fd9\u4e9b\u6587\u6863",
"Automatically generated list of changes in version %(version)s": "\u81ea\u52a8\u751f\u6210\u7684 %(version)s \u7248\u672c\u4e2d\u7684\u66f4\u6539\u5217\u8868",
"C API changes": "C API \u66f4\u6539",
"Changes in Version %(version)s &#8212; %(docstitle)s": "\u66f4\u6539\u53d1\u751f\u5728\u7248\u672c %(version)s&#8212; %(docstitle)s",
"Collapse sidebar": "\u6298\u53e0\u8fb9\u680f",
"Complete Table of Contents": "\u5b8c\u6574\u7684\u5185\u5bb9\u8868",
"Contents": "\u76ee\u5f55",
"Copyright": "\u7248\u6743\u6240\u6709",
"Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> %(sphinx_version)s.": "\u7531 <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> %(sphinx_version)s\u521b\u5efa\u3002",
"Expand sidebar": "\u5c55\u5f00\u8fb9\u680f",
"Full index on one page": "\u4e00\u9875\u7684\u5168\u90e8\u7d22\u5f15",
"General Index": "\u603b\u76ee\u5f55",
"Global Module Index": "\u5168\u5c40\u6a21\u5757\u7d22\u5f15",
"Go": "\u8f6c\u5411",
"Hide Search Matches": "\u9690\u85cf\u641c\u7d22\u7ed3\u679c",
"Index": "\u7d22\u5f15",
"Index &ndash; %(key)s": "\u7d22\u5f15 &ndash; %(key)s",
"Index pages by letter": "\u6309\u7167\u5b57\u6bcd\u7684\u7d22\u5f15\u9875",
"Indices and tables:": "\u7d22\u5f15\u548c\u8868\u683c\uff1a",
"Last updated on %(last_updated)s.": "\u6700\u540e\u66f4\u65b0\u4e8e %(last_updated)s.",
"Library changes": "\u5e93\u66f4\u6539",
"Navigation": "\u5bfc\u822a",
"Next topic": "\u4e0b\u4e00\u4e2a\u4e3b\u9898",
"Other changes": "\u5176\u4ed6\u66f4\u6539",
"Overview": "\u6982\u8ff0",
"Permalink to this definition": "\u6c38\u4e45\u94fe\u63a5\u81f3\u76ee\u6807",
"Permalink to this headline": "\u6c38\u4e45\u94fe\u63a5\u81f3\u6807\u9898",
"Please activate JavaScript to enable the search\n functionality.": "\u8bf7\u6fc0\u6d3b JavaScript \u4ee5\u5f00\u542f\u641c\u7d22\u529f\u80fd\u3002",
"Preparing search...": "\u51c6\u5907\u641c\u7d22\u2026\u2026",
"Previous topic": "\u4e0a\u4e00\u4e2a\u4e3b\u9898",
"Quick search": "\u5feb\u901f\u641c\u7d22",
"Search": "\u641c\u7d22",
"Search Page": "\u641c\u7d22\u9875\u9762",
"Search Results": "\u641c\u7d22\u7ed3\u679c",
"Search finished, found %s page(s) matching the search query.": "\u641c\u7d22\u5b8c\u6210\uff0c\u6709 %s \u4e2a\u9875\u9762\u5339\u914d\u3002",
"Search within %(docstitle)s": "\u5728 %(docstitle)s \u4e2d\u641c\u7d22",
"Searching": "\u641c\u7d22\u4e2d",
"Searching for multiple words only shows matches that contain\n all words.": "\u641c\u5bfb\u5305\u542b\u591a\u4e2a\u5b57\u7684\u8bcd\u6c47\u65f6\uff0c\n \u53ea\u6709\u6240\u542b\u6240\u6709\u5185\u5bb9\u90fd\u5339\u914d\u65f6\u624d\u4f1a\u51fa\u73b0\u3002",
"Show Source": "\u663e\u793a\u6e90\u4ee3\u7801",
"Table of Contents": "\u76ee\u5f55",
"This Page": "\u672c\u9875",
"Welcome! This is": "\u6b22\u8fce\uff01\u8fd9\u662f",
"Your search did not match any documents. Please make sure that all words are spelled correctly and that you've selected enough categories.": "\u6ca1\u6709\u4efb\u4f55\u6587\u6863\u5339\u914d\u60a8\u7684\u641c\u7d22\u3002\u8bf7\u786e\u4fdd\u4f60\u8f93\u5165\u7684\u8bcd\u62fc\u5199\u6b63\u786e\u5e76\u9009\u62e9\u4e86\u5408\u9002\u7684\u5206\u7c7b\u3002",
"all functions, classes, terms": "\u6240\u7684\u51fd\u6570\uff0c\u7c7b\uff0c\u672f\u8bed",
"can be huge": "\u53ef\u80fd\u4f1a\u5f88\u591a",
"last updated": "\u6700\u540e\u66f4\u65b0\u4e8e",
"lists all sections and subsections": "\u5217\u51fa\u6240\u6709\u7684\u7ae0\u8282\u548c\u90e8\u5206",
"next chapter": "\u4e0b\u4e00\u7ae0",
"previous chapter": "\u4e0a\u4e00\u7ae0",
"quick access to all modules": "\u5feb\u901f\u67e5\u770b\u6240\u6709\u7684\u6a21\u5757",
"search": "\u641c\u7d22",
"search this documentation": "\u641c\u7d22\u6587\u6863",
"the documentation for": "\u8fd9\u4efd\u6587\u6863\u662f"
},
"plural_expr": "0"
});

2042
_static/underscore-1.13.1.js Normal file
View File

File diff suppressed because it is too large Load Diff

6
_static/underscore.js Normal file
View File

File diff suppressed because one or more lines are too long

186
archives.html Normal file
View File

@ -0,0 +1,186 @@
<!DOCTYPE html>
<html class="writer-html5" lang="zh-CN" >
<head>
<meta charset="utf-8" /><meta name="generator" content="Docutils 0.17.1: http://docutils.sourceforge.net/" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<title>使用make更新函数库文件 &mdash; 跟我一起写Makefile 1.0 文档</title>
<link rel="stylesheet" href="_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="_static/css/theme.css" type="text/css" />
<!--[if lt IE 9]>
<script src="_static/js/html5shiv.min.js"></script>
<![endif]-->
<script data-url_root="./" id="documentation_options" src="_static/documentation_options.js"></script>
<script src="_static/jquery.js"></script>
<script src="_static/underscore.js"></script>
<script src="_static/doctools.js"></script>
<script src="_static/translations.js"></script>
<script src="_static/js/theme.js"></script>
<link rel="index" title="索引" href="genindex.html" />
<link rel="search" title="搜索" href="search.html" />
<link rel="next" title="后序" href="postscript.html" />
<link rel="prev" title="隐含规则" href="implicit_rules.html" />
</head>
<body class="wy-body-for-nav">
<div class="wy-grid-for-nav">
<nav data-toggle="wy-nav-shift" class="wy-nav-side">
<div class="wy-side-scroll">
<div class="wy-side-nav-search" >
<a href="index.html" class="icon icon-home"> 跟我一起写Makefile
</a>
<div class="version">
1.0
</div>
<div role="search">
<form id="rtd-search-form" class="wy-form" action="search.html" method="get">
<input type="text" name="q" placeholder="Search docs" />
<input type="hidden" name="check_keywords" value="yes" />
<input type="hidden" name="area" value="default" />
</form>
</div>
</div><div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="Navigation menu">
<p class="caption" role="heading"><span class="caption-text">目录</span></p>
<ul class="current">
<li class="toctree-l1"><a class="reference internal" href="overview.html">概述</a></li>
<li class="toctree-l1"><a class="reference internal" href="introduction.html">makefile介绍</a></li>
<li class="toctree-l1"><a class="reference internal" href="rules.html">书写规则</a></li>
<li class="toctree-l1"><a class="reference internal" href="recipes.html">书写命令</a></li>
<li class="toctree-l1"><a class="reference internal" href="variables.html">使用变量</a></li>
<li class="toctree-l1"><a class="reference internal" href="conditionals.html">使用条件判断</a></li>
<li class="toctree-l1"><a class="reference internal" href="functions.html">使用函数</a></li>
<li class="toctree-l1"><a class="reference internal" href="invoke.html">make 的运行</a></li>
<li class="toctree-l1"><a class="reference internal" href="implicit_rules.html">隐含规则</a></li>
<li class="toctree-l1 current"><a class="current reference internal" href="#">使用make更新函数库文件</a><ul>
<li class="toctree-l2"><a class="reference internal" href="#id1">函数库文件的成员</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id2">函数库成员的隐含规则</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id3">函数库文件的后缀规则</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id4">注意事项</a></li>
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="postscript.html">后序</a></li>
</ul>
</div>
</div>
</nav>
<section data-toggle="wy-nav-shift" class="wy-nav-content-wrap"><nav class="wy-nav-top" aria-label="Mobile navigation menu" >
<i data-toggle="wy-nav-top" class="fa fa-bars"></i>
<a href="index.html">跟我一起写Makefile</a>
</nav>
<div class="wy-nav-content">
<div class="rst-content">
<div role="navigation" aria-label="Page navigation">
<ul class="wy-breadcrumbs">
<li><a href="index.html" class="icon icon-home"></a> &raquo;</li>
<li>使用make更新函数库文件</li>
<li class="wy-breadcrumbs-aside">
<a href="_sources/archives.rst.txt" rel="nofollow"> View page source</a>
</li>
</ul>
<hr/>
</div>
<div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
<div itemprop="articleBody">
<section id="make">
<h1>使用make更新函数库文件<a class="headerlink" href="#make" title="永久链接至标题"></a></h1>
<p>函数库文件也就是对Object文件（程序编译的中间文件）的打包文件。在Unix下，一般是由命令 <code class="docutils literal notranslate"><span class="pre">ar</span></code> 来完成打包工作。</p>
<section id="id1">
<h2>函数库文件的成员<a class="headerlink" href="#id1" title="永久链接至标题"></a></h2>
<p>一个函数库文件由多个文件组成。你可以用如下格式指定函数库文件及其组成:</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">archive</span><span class="p">(</span><span class="n">member</span><span class="p">)</span>
</pre></div>
</div>
<p>这个不是一个命令，而一个目标和依赖的定义。一般来说，这种用法基本上就是为了
<code class="docutils literal notranslate"><span class="pre">ar</span></code> 命令来服务的。如:</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">foolib</span><span class="p">(</span><span class="n">hack</span><span class="o">.</span><span class="n">o</span><span class="p">)</span> <span class="p">:</span> <span class="n">hack</span><span class="o">.</span><span class="n">o</span>
<span class="n">ar</span> <span class="n">cr</span> <span class="n">foolib</span> <span class="n">hack</span><span class="o">.</span><span class="n">o</span>
</pre></div>
</div>
<p>如果要指定多个member，那就以空格分开，如:</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">foolib</span><span class="p">(</span><span class="n">hack</span><span class="o">.</span><span class="n">o</span> <span class="n">kludge</span><span class="o">.</span><span class="n">o</span><span class="p">)</span>
</pre></div>
</div>
<p>其等价于:</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">foolib</span><span class="p">(</span><span class="n">hack</span><span class="o">.</span><span class="n">o</span><span class="p">)</span> <span class="n">foolib</span><span class="p">(</span><span class="n">kludge</span><span class="o">.</span><span class="n">o</span><span class="p">)</span>
</pre></div>
</div>
<p>你还可以使用Shell的文件通配符来定义，如:</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">foolib</span><span class="p">(</span><span class="o">*.</span><span class="n">o</span><span class="p">)</span>
</pre></div>
</div>
</section>
<section id="id2">
<h2>函数库成员的隐含规则<a class="headerlink" href="#id2" title="永久链接至标题"></a></h2>
<p>当make搜索一个目标的隐含规则时，一个特殊的特性是，如果这个目标是 <code class="docutils literal notranslate"><span class="pre">a(m)</span></code> 形式的，其会把目标变成 <code class="docutils literal notranslate"><span class="pre">(m)</span></code> 。于是，如果我们的成员是 <code class="docutils literal notranslate"><span class="pre">%.o</span></code> 的模式定义，并且如果我们使用 <code class="docutils literal notranslate"><span class="pre">make</span> <span class="pre">foo.a(bar.o)</span></code> 的形式调用Makefile时，隐含规则会去找 <code class="docutils literal notranslate"><span class="pre">bar.o</span></code> 的规则，如果没有定义 <code class="docutils literal notranslate"><span class="pre">bar.o</span></code> 的规则，那么内建隐含规则生效，make会去找 <code class="docutils literal notranslate"><span class="pre">bar.c</span></code>
文件来生成 <code class="docutils literal notranslate"><span class="pre">bar.o</span></code> ，如果找得到的话，make执行的命令大致如下:</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">cc</span> <span class="o">-</span><span class="n">c</span> <span class="n">bar</span><span class="o">.</span><span class="n">c</span> <span class="o">-</span><span class="n">o</span> <span class="n">bar</span><span class="o">.</span><span class="n">o</span>
<span class="n">ar</span> <span class="n">r</span> <span class="n">foo</span><span class="o">.</span><span class="n">a</span> <span class="n">bar</span><span class="o">.</span><span class="n">o</span>
<span class="n">rm</span> <span class="o">-</span><span class="n">f</span> <span class="n">bar</span><span class="o">.</span><span class="n">o</span>
</pre></div>
</div>
<p>还有一个变量要注意的是 <code class="docutils literal notranslate"><span class="pre">$%</span></code> ，这是专属函数库文件的自动化变量，有关其说明请参见“自动化变量”一节。</p>
</section>
<section id="id3">
<h2>函数库文件的后缀规则<a class="headerlink" href="#id3" title="永久链接至标题"></a></h2>
<p>你可以使用“后缀规则”和“隐含规则”来生成函数库打包文件，如：</p>
<div class="highlight-makefile notranslate"><div class="highlight"><pre><span></span><span class="nf">.c.a</span><span class="o">:</span>
<span class="k">$(</span>CC<span class="k">)</span> <span class="k">$(</span>CFLAGS<span class="k">)</span> <span class="k">$(</span>CPPFLAGS<span class="k">)</span> -c $&lt; -o <span class="nv">$*</span>.o
<span class="k">$(</span>AR<span class="k">)</span> r <span class="nv">$@</span> <span class="nv">$*</span>.o
<span class="k">$(</span>RM<span class="k">)</span> <span class="nv">$*</span>.o
</pre></div>
</div>
<p>其等效于：</p>
<div class="highlight-makefile notranslate"><div class="highlight"><pre><span></span><span class="nf">(%.o) </span><span class="o">:</span> %.<span class="n">c</span>
<span class="k">$(</span>CC<span class="k">)</span> <span class="k">$(</span>CFLAGS<span class="k">)</span> <span class="k">$(</span>CPPFLAGS<span class="k">)</span> -c $&lt; -o <span class="nv">$*</span>.o
<span class="k">$(</span>AR<span class="k">)</span> r <span class="nv">$@</span> <span class="nv">$*</span>.o
<span class="k">$(</span>RM<span class="k">)</span> <span class="nv">$*</span>.o
</pre></div>
</div>
</section>
<section id="id4">
<h2>注意事项<a class="headerlink" href="#id4" title="永久链接至标题"></a></h2>
<p>在进行函数库打包文件生成时，请小心使用make的并行机制（ <code class="docutils literal notranslate"><span class="pre">-j</span></code> 参数）。如果多个
<code class="docutils literal notranslate"><span class="pre">ar</span></code> 命令在同一时间运行在同一个函数库打包文件上，就很有可以损坏这个函数库文件。所以，在make未来的版本中，应该提供一种机制来避免并行操作发生在函数打包文件上。</p>
<p>但就目前而言，你还是应该不要尽量不要使用 <code class="docutils literal notranslate"><span class="pre">-j</span></code> 参数。</p>
</section>
</section>
</div>
</div>
<footer><div class="rst-footer-buttons" role="navigation" aria-label="Footer">
<a href="implicit_rules.html" class="btn btn-neutral float-left" title="隐含规则" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
<a href="postscript.html" class="btn btn-neutral float-right" title="后序" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
</div>
<hr/>
<div role="contentinfo">
<p>&#169; 版权所有 2014-2019, 作者：陈皓；排版：SeisMan.
<span class="lastupdated">最后更新于 2022年5月22日.
</span></p>
</div>
Built with <a href="https://www.sphinx-doc.org/">Sphinx</a> using a
<a href="https://github.com/readthedocs/sphinx_rtd_theme">theme</a>
provided by <a href="https://readthedocs.org">Read the Docs</a>.
</footer>
</div>
</div>
</section>
</div>
<script>
jQuery(function () {
SphinxRtdTheme.Navigation.enable(true);
});
</script>
</body>
</html>

244
conditionals.html Normal file
View File

@ -0,0 +1,244 @@
<!DOCTYPE html>
<html class="writer-html5" lang="zh-CN" >
<head>
<meta charset="utf-8" /><meta name="generator" content="Docutils 0.17.1: http://docutils.sourceforge.net/" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<title>使用条件判断 &mdash; 跟我一起写Makefile 1.0 文档</title>
<link rel="stylesheet" href="_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="_static/css/theme.css" type="text/css" />
<!--[if lt IE 9]>
<script src="_static/js/html5shiv.min.js"></script>
<![endif]-->
<script data-url_root="./" id="documentation_options" src="_static/documentation_options.js"></script>
<script src="_static/jquery.js"></script>
<script src="_static/underscore.js"></script>
<script src="_static/doctools.js"></script>
<script src="_static/translations.js"></script>
<script src="_static/js/theme.js"></script>
<link rel="index" title="索引" href="genindex.html" />
<link rel="search" title="搜索" href="search.html" />
<link rel="next" title="使用函数" href="functions.html" />
<link rel="prev" title="使用变量" href="variables.html" />
</head>
<body class="wy-body-for-nav">
<div class="wy-grid-for-nav">
<nav data-toggle="wy-nav-shift" class="wy-nav-side">
<div class="wy-side-scroll">
<div class="wy-side-nav-search" >
<a href="index.html" class="icon icon-home"> 跟我一起写Makefile
</a>
<div class="version">
1.0
</div>
<div role="search">
<form id="rtd-search-form" class="wy-form" action="search.html" method="get">
<input type="text" name="q" placeholder="Search docs" />
<input type="hidden" name="check_keywords" value="yes" />
<input type="hidden" name="area" value="default" />
</form>
</div>
</div><div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="Navigation menu">
<p class="caption" role="heading"><span class="caption-text">目录</span></p>
<ul class="current">
<li class="toctree-l1"><a class="reference internal" href="overview.html">概述</a></li>
<li class="toctree-l1"><a class="reference internal" href="introduction.html">makefile介绍</a></li>
<li class="toctree-l1"><a class="reference internal" href="rules.html">书写规则</a></li>
<li class="toctree-l1"><a class="reference internal" href="recipes.html">书写命令</a></li>
<li class="toctree-l1"><a class="reference internal" href="variables.html">使用变量</a></li>
<li class="toctree-l1 current"><a class="current reference internal" href="#">使用条件判断</a><ul>
<li class="toctree-l2"><a class="reference internal" href="#id2">示例</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id3">语法</a></li>
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="functions.html">使用函数</a></li>
<li class="toctree-l1"><a class="reference internal" href="invoke.html">make 的运行</a></li>
<li class="toctree-l1"><a class="reference internal" href="implicit_rules.html">隐含规则</a></li>
<li class="toctree-l1"><a class="reference internal" href="archives.html">使用make更新函数库文件</a></li>
<li class="toctree-l1"><a class="reference internal" href="postscript.html">后序</a></li>
</ul>
</div>
</div>
</nav>
<section data-toggle="wy-nav-shift" class="wy-nav-content-wrap"><nav class="wy-nav-top" aria-label="Mobile navigation menu" >
<i data-toggle="wy-nav-top" class="fa fa-bars"></i>
<a href="index.html">跟我一起写Makefile</a>
</nav>
<div class="wy-nav-content">
<div class="rst-content">
<div role="navigation" aria-label="Page navigation">
<ul class="wy-breadcrumbs">
<li><a href="index.html" class="icon icon-home"></a> &raquo;</li>
<li>使用条件判断</li>
<li class="wy-breadcrumbs-aside">
<a href="_sources/conditionals.rst.txt" rel="nofollow"> View page source</a>
</li>
</ul>
<hr/>
</div>
<div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
<div itemprop="articleBody">
<section id="id1">
<h1>使用条件判断<a class="headerlink" href="#id1" title="永久链接至标题"></a></h1>
<p>使用条件判断，可以让make根据运行时的不同情况选择不同的执行分支。条件表达式可以是比较变量的值，或是比较变量和常量的值。</p>
<section id="id2">
<h2>示例<a class="headerlink" href="#id2" title="永久链接至标题"></a></h2>
<p>下面的例子，判断 <code class="docutils literal notranslate"><span class="pre">$(CC)</span></code> 变量是否 <code class="docutils literal notranslate"><span class="pre">gcc</span></code> ，如果是的话，则使用GNU函数编译目标。</p>
<div class="highlight-makefile notranslate"><div class="highlight"><pre><span></span><span class="nv">libs_for_gcc</span> <span class="o">=</span> -lgnu
<span class="nv">normal_libs</span> <span class="o">=</span>
<span class="nf">foo</span><span class="o">:</span> <span class="k">$(</span><span class="nv">objects</span><span class="k">)</span>
<span class="cp">ifeq ($(CC),gcc)</span>
<span class="k">$(</span>CC<span class="k">)</span> -o foo <span class="k">$(</span>objects<span class="k">)</span> <span class="k">$(</span>libs_for_gcc<span class="k">)</span>
<span class="cp">else</span>
<span class="k">$(</span>CC<span class="k">)</span> -o foo <span class="k">$(</span>objects<span class="k">)</span> <span class="k">$(</span>normal_libs<span class="k">)</span>
<span class="cp">endif</span>
</pre></div>
</div>
<p>可见，在上面示例的这个规则中，目标 <code class="docutils literal notranslate"><span class="pre">foo</span></code> 可以根据变量 <code class="docutils literal notranslate"><span class="pre">$(CC)</span></code> 值来选取不同的函数库来编译程序。</p>
<p>我们可以从上面的示例中看到三个关键字： <code class="docutils literal notranslate"><span class="pre">ifeq</span></code> 、 <code class="docutils literal notranslate"><span class="pre">else</span></code> 和 <code class="docutils literal notranslate"><span class="pre">endif</span></code> 。 <code class="docutils literal notranslate"><span class="pre">ifeq</span></code> 的意思表示条件语句的开始，并指定一个条件表达式，表达式包含两个参数，以逗号分隔，表达式以圆括号括起。 <code class="docutils literal notranslate"><span class="pre">else</span></code> 表示条件表达式为假的情况。 <code class="docutils literal notranslate"><span class="pre">endif</span></code> 表示一个条件语句的结束，任何一个条件表达式都应该以 <code class="docutils literal notranslate"><span class="pre">endif</span></code> 结束。</p>
<p>当我们的变量 <code class="docutils literal notranslate"><span class="pre">$(CC)</span></code> 值是 <code class="docutils literal notranslate"><span class="pre">gcc</span></code> 时，目标 <code class="docutils literal notranslate"><span class="pre">foo</span></code> 的规则是：</p>
<div class="highlight-makefile notranslate"><div class="highlight"><pre><span></span><span class="nf">foo</span><span class="o">:</span> <span class="k">$(</span><span class="nv">objects</span><span class="k">)</span>
<span class="k">$(</span>CC<span class="k">)</span> -o foo <span class="k">$(</span>objects<span class="k">)</span> <span class="k">$(</span>libs_for_gcc<span class="k">)</span>
</pre></div>
</div>
<p>而当我们的变量 <code class="docutils literal notranslate"><span class="pre">$(CC)</span></code> 值不是 <code class="docutils literal notranslate"><span class="pre">gcc</span></code> 时（比如 <code class="docutils literal notranslate"><span class="pre">cc</span></code> ），目标 <code class="docutils literal notranslate"><span class="pre">foo</span></code> 的规则是：</p>
<div class="highlight-makefile notranslate"><div class="highlight"><pre><span></span><span class="nf">foo</span><span class="o">:</span> <span class="k">$(</span><span class="nv">objects</span><span class="k">)</span>
<span class="k">$(</span>CC<span class="k">)</span> -o foo <span class="k">$(</span>objects<span class="k">)</span> <span class="k">$(</span>normal_libs<span class="k">)</span>
</pre></div>
</div>
<p>当然，我们还可以把上面的那个例子写得更简洁一些：</p>
<div class="highlight-makefile notranslate"><div class="highlight"><pre><span></span><span class="nv">libs_for_gcc</span> <span class="o">=</span> -lgnu
<span class="nv">normal_libs</span> <span class="o">=</span>
<span class="cp">ifeq ($(CC),gcc)</span>
<span class="nv">libs</span><span class="o">=</span><span class="k">$(</span>libs_for_gcc<span class="k">)</span>
<span class="cp">else</span>
<span class="nv">libs</span><span class="o">=</span><span class="k">$(</span>normal_libs<span class="k">)</span>
<span class="cp">endif</span>
<span class="nf">foo</span><span class="o">:</span> <span class="k">$(</span><span class="nv">objects</span><span class="k">)</span>
<span class="k">$(</span>CC<span class="k">)</span> -o foo <span class="k">$(</span>objects<span class="k">)</span> <span class="k">$(</span>libs<span class="k">)</span>
</pre></div>
</div>
</section>
<section id="id3">
<h2>语法<a class="headerlink" href="#id3" title="永久链接至标题"></a></h2>
<p>条件表达式的语法为:</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="o">&lt;</span><span class="n">conditional</span><span class="o">-</span><span class="n">directive</span><span class="o">&gt;</span>
<span class="o">&lt;</span><span class="n">text</span><span class="o">-</span><span class="k">if</span><span class="o">-</span><span class="n">true</span><span class="o">&gt;</span>
<span class="n">endif</span>
</pre></div>
</div>
<p>以及:</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="o">&lt;</span><span class="n">conditional</span><span class="o">-</span><span class="n">directive</span><span class="o">&gt;</span>
<span class="o">&lt;</span><span class="n">text</span><span class="o">-</span><span class="k">if</span><span class="o">-</span><span class="n">true</span><span class="o">&gt;</span>
<span class="k">else</span>
<span class="o">&lt;</span><span class="n">text</span><span class="o">-</span><span class="k">if</span><span class="o">-</span><span class="n">false</span><span class="o">&gt;</span>
<span class="n">endif</span>
</pre></div>
</div>
<p>其中 <code class="docutils literal notranslate"><span class="pre">&lt;conditional-directive&gt;</span></code> 表示条件关键字，如 <code class="docutils literal notranslate"><span class="pre">ifeq</span></code> 。这个关键字有四个。</p>
<p>第一个是我们前面所见过的 <code class="docutils literal notranslate"><span class="pre">ifeq</span></code></p>
<div class="highlight-makefile notranslate"><div class="highlight"><pre><span></span><span class="cp">ifeq (&lt;arg1&gt;, &lt;arg2&gt;)</span>
<span class="cp">ifeq &#39;&lt;arg1&gt;&#39; &#39;&lt;arg2&gt;&#39;</span>
<span class="cp">ifeq &quot;&lt;arg1&gt;&quot; &quot;&lt;arg2&gt;&quot;</span>
<span class="cp">ifeq &quot;&lt;arg1&gt;&quot; &#39;&lt;arg2&gt;&#39;</span>
<span class="cp">ifeq &#39;&lt;arg1&gt;&#39; &quot;&lt;arg2&gt;&quot;</span>
</pre></div>
</div>
<p>比较参数 <code class="docutils literal notranslate"><span class="pre">arg1</span></code> 和 <code class="docutils literal notranslate"><span class="pre">arg2</span></code> 的值是否相同。当然，参数中我们还可以使用make的函数。如:</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span>ifeq ($(strip $(foo)),)
&lt;text-if-empty&gt;
endif
</pre></div>
</div>
<p>这个示例中使用了 <code class="docutils literal notranslate"><span class="pre">strip</span></code> 函数，如果这个函数的返回值是空（Empty），那么
<code class="docutils literal notranslate"><span class="pre">&lt;text-if-empty&gt;</span></code> 就生效。</p>
<p>第二个条件关键字是 <code class="docutils literal notranslate"><span class="pre">ifneq</span></code> 。语法是：</p>
<div class="highlight-makefile notranslate"><div class="highlight"><pre><span></span><span class="cp">ifneq (&lt;arg1&gt;, &lt;arg2&gt;)</span>
<span class="cp">ifneq &#39;&lt;arg1&gt;&#39; &#39;&lt;arg2&gt;&#39;</span>
<span class="cp">ifneq &quot;&lt;arg1&gt;&quot; &quot;&lt;arg2&gt;&quot;</span>
<span class="cp">ifneq &quot;&lt;arg1&gt;&quot; &#39;&lt;arg2&gt;&#39;</span>
<span class="cp">ifneq &#39;&lt;arg1&gt;&#39; &quot;&lt;arg2&gt;&quot;</span>
</pre></div>
</div>
<p>其比较参数 <code class="docutils literal notranslate"><span class="pre">arg1</span></code> 和 <code class="docutils literal notranslate"><span class="pre">arg2</span></code> 的值是否相同，如果不同，则为真。和 <code class="docutils literal notranslate"><span class="pre">ifeq</span></code> 类似。</p>
<p>第三个条件关键字是 <code class="docutils literal notranslate"><span class="pre">ifdef</span></code> 。语法是：</p>
<div class="highlight-makefile notranslate"><div class="highlight"><pre><span></span><span class="cp">ifdef &lt;variable-name&gt;</span>
</pre></div>
</div>
<p>如果变量 <code class="docutils literal notranslate"><span class="pre">&lt;variable-name&gt;</span></code> 的值非空，那到表达式为真。否则，表达式为假。当然，
<code class="docutils literal notranslate"><span class="pre">&lt;variable-name&gt;</span></code> 同样可以是一个函数的返回值。注意， <code class="docutils literal notranslate"><span class="pre">ifdef</span></code> 只是测试一个变量是否有值，其并不会把变量扩展到当前位置。还是来看两个例子：</p>
<p>示例一：</p>
<div class="highlight-makefile notranslate"><div class="highlight"><pre><span></span><span class="nv">bar</span> <span class="o">=</span>
<span class="nv">foo</span> <span class="o">=</span> <span class="k">$(</span>bar<span class="k">)</span>
<span class="cp">ifdef foo</span>
<span class="nv">frobozz</span> <span class="o">=</span> yes
<span class="cp">else</span>
<span class="nv">frobozz</span> <span class="o">=</span> no
<span class="cp">endif</span>
</pre></div>
</div>
<p>示例二：</p>
<div class="highlight-makefile notranslate"><div class="highlight"><pre><span></span><span class="nv">foo</span> <span class="o">=</span>
<span class="cp">ifdef foo</span>
<span class="nv">frobozz</span> <span class="o">=</span> yes
<span class="cp">else</span>
<span class="nv">frobozz</span> <span class="o">=</span> no
<span class="cp">endif</span>
</pre></div>
</div>
<p>第一个例子中， <code class="docutils literal notranslate"><span class="pre">$(frobozz)</span></code> 值是 <code class="docutils literal notranslate"><span class="pre">yes</span></code> ，第二个则是 <code class="docutils literal notranslate"><span class="pre">no</span></code>。</p>
<p>第四个条件关键字是 <code class="docutils literal notranslate"><span class="pre">ifndef</span></code> 。其语法是：</p>
<div class="highlight-makefile notranslate"><div class="highlight"><pre><span></span><span class="cp">ifndef &lt;variable-name&gt;</span>
</pre></div>
</div>
<p>这个我就不多说了，和 <code class="docutils literal notranslate"><span class="pre">ifdef</span></code> 是相反的意思。</p>
<p>在 <code class="docutils literal notranslate"><span class="pre">&lt;conditional-directive&gt;</span></code> 这一行上，多余的空格是被允许的，但是不能以 <code class="docutils literal notranslate"><span class="pre">Tab</span></code> 键作为开始（不然就被认为是命令）。而注释符 <code class="docutils literal notranslate"><span class="pre">#</span></code> 同样也是安全的。 <code class="docutils literal notranslate"><span class="pre">else</span></code> 和 <code class="docutils literal notranslate"><span class="pre">endif</span></code>
也一样，只要不是以 <code class="docutils literal notranslate"><span class="pre">Tab</span></code> 键开始就行了。</p>
<p>特别注意的是，make是在读取Makefile时就计算条件表达式的值，并根据条件表达式的值来选择语句，所以，你最好不要把自动化变量（如 <code class="docutils literal notranslate"><span class="pre">$&#64;</span></code> 等）放入条件表达式中，因为自动化变量是在运行时才有的。</p>
<p>而且为了避免混乱，make不允许把整个条件语句分成两部分放在不同的文件中。</p>
</section>
</section>
</div>
</div>
<footer><div class="rst-footer-buttons" role="navigation" aria-label="Footer">
<a href="variables.html" class="btn btn-neutral float-left" title="使用变量" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
<a href="functions.html" class="btn btn-neutral float-right" title="使用函数" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
</div>
<hr/>
<div role="contentinfo">
<p>&#169; 版权所有 2014-2019, 作者：陈皓；排版：SeisMan.
<span class="lastupdated">最后更新于 2022年5月22日.
</span></p>
</div>
Built with <a href="https://www.sphinx-doc.org/">Sphinx</a> using a
<a href="https://github.com/readthedocs/sphinx_rtd_theme">theme</a>
provided by <a href="https://readthedocs.org">Read the Docs</a>.
</footer>
</div>
</div>
</section>
</div>
<script>
jQuery(function () {
SphinxRtdTheme.Navigation.enable(true);
});
</script>
</body>
</html>

606
functions.html Normal file
View File

@ -0,0 +1,606 @@
<!DOCTYPE html>
<html class="writer-html5" lang="zh-CN" >
<head>
<meta charset="utf-8" /><meta name="generator" content="Docutils 0.17.1: http://docutils.sourceforge.net/" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<title>使用函数 &mdash; 跟我一起写Makefile 1.0 文档</title>
<link rel="stylesheet" href="_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="_static/css/theme.css" type="text/css" />
<!--[if lt IE 9]>
<script src="_static/js/html5shiv.min.js"></script>
<![endif]-->
<script data-url_root="./" id="documentation_options" src="_static/documentation_options.js"></script>
<script src="_static/jquery.js"></script>
<script src="_static/underscore.js"></script>
<script src="_static/doctools.js"></script>
<script src="_static/translations.js"></script>
<script src="_static/js/theme.js"></script>
<link rel="index" title="索引" href="genindex.html" />
<link rel="search" title="搜索" href="search.html" />
<link rel="next" title="make 的运行" href="invoke.html" />
<link rel="prev" title="使用条件判断" href="conditionals.html" />
</head>
<body class="wy-body-for-nav">
<div class="wy-grid-for-nav">
<nav data-toggle="wy-nav-shift" class="wy-nav-side">
<div class="wy-side-scroll">
<div class="wy-side-nav-search" >
<a href="index.html" class="icon icon-home"> 跟我一起写Makefile
</a>
<div class="version">
1.0
</div>
<div role="search">
<form id="rtd-search-form" class="wy-form" action="search.html" method="get">
<input type="text" name="q" placeholder="Search docs" />
<input type="hidden" name="check_keywords" value="yes" />
<input type="hidden" name="area" value="default" />
</form>
</div>
</div><div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="Navigation menu">
<p class="caption" role="heading"><span class="caption-text">目录</span></p>
<ul class="current">
<li class="toctree-l1"><a class="reference internal" href="overview.html">概述</a></li>
<li class="toctree-l1"><a class="reference internal" href="introduction.html">makefile介绍</a></li>
<li class="toctree-l1"><a class="reference internal" href="rules.html">书写规则</a></li>
<li class="toctree-l1"><a class="reference internal" href="recipes.html">书写命令</a></li>
<li class="toctree-l1"><a class="reference internal" href="variables.html">使用变量</a></li>
<li class="toctree-l1"><a class="reference internal" href="conditionals.html">使用条件判断</a></li>
<li class="toctree-l1 current"><a class="current reference internal" href="#">使用函数</a><ul>
<li class="toctree-l2"><a class="reference internal" href="#id2">函数的调用语法</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id3">字符串处理函数</a><ul>
<li class="toctree-l3"><a class="reference internal" href="#subst">subst</a></li>
<li class="toctree-l3"><a class="reference internal" href="#patsubst">patsubst</a></li>
<li class="toctree-l3"><a class="reference internal" href="#strip">strip</a></li>
<li class="toctree-l3"><a class="reference internal" href="#findstring">findstring</a></li>
<li class="toctree-l3"><a class="reference internal" href="#filter">filter</a></li>
<li class="toctree-l3"><a class="reference internal" href="#filter-out">filter-out</a></li>
<li class="toctree-l3"><a class="reference internal" href="#sort">sort</a></li>
<li class="toctree-l3"><a class="reference internal" href="#word">word</a></li>
<li class="toctree-l3"><a class="reference internal" href="#wordlist">wordlist</a></li>
<li class="toctree-l3"><a class="reference internal" href="#words">words</a></li>
<li class="toctree-l3"><a class="reference internal" href="#firstword">firstword</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="#id4">文件名操作函数</a><ul>
<li class="toctree-l3"><a class="reference internal" href="#dir">dir</a></li>
<li class="toctree-l3"><a class="reference internal" href="#notdir">notdir</a></li>
<li class="toctree-l3"><a class="reference internal" href="#suffix">suffix</a></li>
<li class="toctree-l3"><a class="reference internal" href="#basename">basename</a></li>
<li class="toctree-l3"><a class="reference internal" href="#addsuffix">addsuffix</a></li>
<li class="toctree-l3"><a class="reference internal" href="#addprefix">addprefix</a></li>
<li class="toctree-l3"><a class="reference internal" href="#join">join</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="#foreach">foreach 函数</a></li>
<li class="toctree-l2"><a class="reference internal" href="#if">if 函数</a></li>
<li class="toctree-l2"><a class="reference internal" href="#call">call函数</a></li>
<li class="toctree-l2"><a class="reference internal" href="#origin">origin函数</a></li>
<li class="toctree-l2"><a class="reference internal" href="#shell">shell函数</a></li>
<li class="toctree-l2"><a class="reference internal" href="#make">控制make的函数</a></li>
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="invoke.html">make 的运行</a></li>
<li class="toctree-l1"><a class="reference internal" href="implicit_rules.html">隐含规则</a></li>
<li class="toctree-l1"><a class="reference internal" href="archives.html">使用make更新函数库文件</a></li>
<li class="toctree-l1"><a class="reference internal" href="postscript.html">后序</a></li>
</ul>
</div>
</div>
</nav>
<section data-toggle="wy-nav-shift" class="wy-nav-content-wrap"><nav class="wy-nav-top" aria-label="Mobile navigation menu" >
<i data-toggle="wy-nav-top" class="fa fa-bars"></i>
<a href="index.html">跟我一起写Makefile</a>
</nav>
<div class="wy-nav-content">
<div class="rst-content">
<div role="navigation" aria-label="Page navigation">
<ul class="wy-breadcrumbs">
<li><a href="index.html" class="icon icon-home"></a> &raquo;</li>
<li>使用函数</li>
<li class="wy-breadcrumbs-aside">
<a href="_sources/functions.rst.txt" rel="nofollow"> View page source</a>
</li>
</ul>
<hr/>
</div>
<div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
<div itemprop="articleBody">
<section id="id1">
<h1>使用函数<a class="headerlink" href="#id1" title="永久链接至标题"></a></h1>
<p>在Makefile中可以使用函数来处理变量，从而让我们的命令或是规则更为的灵活和具有智能。make
所支持的函数也不算很多，不过已经足够我们的操作了。函数调用后，函数的返回值可以当做变量来使用。</p>
<section id="id2">
<h2>函数的调用语法<a class="headerlink" href="#id2" title="永久链接至标题"></a></h2>
<p>函数调用，很像变量的使用，也是以 <code class="docutils literal notranslate"><span class="pre">$</span></code> 来标识的，其语法如下：</p>
<div class="highlight-makefile notranslate"><div class="highlight"><pre><span></span><span class="k">$(</span>&lt;<span class="nv">function</span>&gt; &lt;<span class="nv">arguments</span>&gt;<span class="k">)</span><span class="w"></span>
</pre></div>
</div>
<p>或是:</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span>${&lt;function&gt; &lt;arguments&gt;}
</pre></div>
</div>
<p>这里， <code class="docutils literal notranslate"><span class="pre">&lt;function&gt;</span></code> 就是函数名，make支持的函数不多。 <code class="docutils literal notranslate"><span class="pre">&lt;arguments&gt;</span></code> 为函数的参数，参数间以逗号 <code class="docutils literal notranslate"><span class="pre">,</span></code> 分隔，而函数名和参数之间以“空格”分隔。函数调用以 <code class="docutils literal notranslate"><span class="pre">$</span></code> 开头，以圆括号或花括号把函数名和参数括起。感觉很像一个变量，是不是？函数中的参数可以使用变量，为了风格的统一，函数和变量的括号最好一样，如使用 <code class="docutils literal notranslate"><span class="pre">$(subst</span> <span class="pre">a,b,$(x))</span></code> 这样的形式，而不是
<code class="docutils literal notranslate"><span class="pre">$(subst</span> <span class="pre">a,b,</span> <span class="pre">${x})</span></code> 的形式。因为统一会更清楚，也会减少一些不必要的麻烦。</p>
<p>还是来看一个示例：</p>
<div class="highlight-makefile notranslate"><div class="highlight"><pre><span></span><span class="nv">comma</span><span class="o">:=</span> ,
<span class="nv">empty</span><span class="o">:=</span>
<span class="nv">space</span><span class="o">:=</span> <span class="k">$(</span>empty<span class="k">)</span> <span class="k">$(</span>empty<span class="k">)</span>
<span class="nv">foo</span><span class="o">:=</span> a b c
<span class="nv">bar</span><span class="o">:=</span> <span class="k">$(</span>subst <span class="k">$(</span>space<span class="k">)</span>,<span class="k">$(</span>comma<span class="k">)</span>,<span class="k">$(</span>foo<span class="k">))</span>
</pre></div>
</div>
<p>在这个示例中， <code class="docutils literal notranslate"><span class="pre">$(comma)</span></code> 的值是一个逗号。 <code class="docutils literal notranslate"><span class="pre">$(space)</span></code> 使用了 <code class="docutils literal notranslate"><span class="pre">$(empty)</span></code> 定义了一个空格， <code class="docutils literal notranslate"><span class="pre">$(foo)</span></code> 的值是 <code class="docutils literal notranslate"><span class="pre">a</span> <span class="pre">b</span> <span class="pre">c</span></code> ， <code class="docutils literal notranslate"><span class="pre">$(bar)</span></code> 的定义用，调用了函数 <code class="docutils literal notranslate"><span class="pre">subst</span></code> ，这是一个替换函数，这个函数有三个参数，第一个参数是被替换字串，第二个参数是替换字串，第三个参数是替换操作作用的字串。这个函数也就是把 <code class="docutils literal notranslate"><span class="pre">$(foo)</span></code> 中的空格替换成逗号，所以 <code class="docutils literal notranslate"><span class="pre">$(bar)</span></code> 的值是 <code class="docutils literal notranslate"><span class="pre">a,b,c</span></code> 。</p>
</section>
<section id="id3">
<h2>字符串处理函数<a class="headerlink" href="#id3" title="永久链接至标题"></a></h2>
<section id="subst">
<h3>subst<a class="headerlink" href="#subst" title="永久链接至标题"></a></h3>
<div class="highlight-makefile notranslate"><div class="highlight"><pre><span></span><span class="k">$(</span><span class="nv">subst</span> &lt;<span class="nv">from</span>&gt;,&lt;<span class="nv">to</span>&gt;,&lt;<span class="nv">text</span>&gt;<span class="k">)</span><span class="w"></span>
</pre></div>
</div>
<ul>
<li><p>名称：字符串替换函数</p></li>
<li><p>功能：把字串 <code class="docutils literal notranslate"><span class="pre">&lt;text&gt;</span></code> 中的 <code class="docutils literal notranslate"><span class="pre">&lt;from&gt;</span></code> 字符串替换成 <code class="docutils literal notranslate"><span class="pre">&lt;to&gt;</span></code> 。</p></li>
<li><p>返回：函数返回被替换过后的字符串。</p></li>
<li><p>示例：</p>
<blockquote>
<div><div class="highlight-makefile notranslate"><div class="highlight"><pre><span></span><span class="k">$(</span><span class="nv">subst</span> <span class="nv">ee</span>,<span class="nv">EE</span>,<span class="nv">feet</span> <span class="nv">on</span> <span class="nv">the</span> <span class="nv">street</span><span class="k">)</span><span class="w"></span>
</pre></div>
</div>
</div></blockquote>
</li>
</ul>
<p>把 <code class="docutils literal notranslate"><span class="pre">feet</span> <span class="pre">on</span> <span class="pre">the</span> <span class="pre">street</span></code> 中的 <code class="docutils literal notranslate"><span class="pre">ee</span></code> 替换成 <code class="docutils literal notranslate"><span class="pre">EE</span></code> ，返回结果是 <code class="docutils literal notranslate"><span class="pre">fEEt</span> <span class="pre">on</span> <span class="pre">the</span> <span class="pre">strEEt</span></code> 。</p>
</section>
<section id="patsubst">
<h3>patsubst<a class="headerlink" href="#patsubst" title="永久链接至标题"></a></h3>
<div class="highlight-makefile notranslate"><div class="highlight"><pre><span></span><span class="k">$(</span><span class="nv">patsubst</span> &lt;<span class="nv">pattern</span>&gt;,&lt;<span class="nv">replacement</span>&gt;,&lt;<span class="nv">text</span>&gt;<span class="k">)</span><span class="w"></span>
</pre></div>
</div>
<ul>
<li><p>名称：模式字符串替换函数。</p></li>
<li><p>功能：查找 <code class="docutils literal notranslate"><span class="pre">&lt;text&gt;</span></code> 中的单词（单词以“空格”、“Tab”或“回车”“换行”分隔）是否符合模式
<code class="docutils literal notranslate"><span class="pre">&lt;pattern&gt;</span></code> ，如果匹配的话，则以 <code class="docutils literal notranslate"><span class="pre">&lt;replacement&gt;</span></code> 替换。这里， <code class="docutils literal notranslate"><span class="pre">&lt;pattern&gt;</span></code> 可以包括通配符 <code class="docutils literal notranslate"><span class="pre">%</span></code> ，表示任意长度的字串。如果 <code class="docutils literal notranslate"><span class="pre">&lt;replacement&gt;</span></code> 中也包含 <code class="docutils literal notranslate"><span class="pre">%</span></code> ，那么，
<code class="docutils literal notranslate"><span class="pre">&lt;replacement&gt;</span></code> 中的这个 <code class="docutils literal notranslate"><span class="pre">%</span></code> 将是 <code class="docutils literal notranslate"><span class="pre">&lt;pattern&gt;</span></code> 中的那个 <code class="docutils literal notranslate"><span class="pre">%</span></code> 所代表的字串。（可以用 <code class="docutils literal notranslate"><span class="pre">\</span></code> 来转义，以 <code class="docutils literal notranslate"><span class="pre">\%</span></code> 来表示真实含义的 <code class="docutils literal notranslate"><span class="pre">%</span></code> 字符）</p></li>
<li><p>返回：函数返回被替换过后的字符串。</p></li>
<li><p>示例：</p>
<blockquote>
<div><div class="highlight-makefile notranslate"><div class="highlight"><pre><span></span><span class="k">$(</span><span class="nv">patsubst</span> %<span class="nv">.c</span>,%<span class="nv">.o</span>,<span class="nv">x.c.c</span> <span class="nv">bar.c</span><span class="k">)</span><span class="w"></span>
</pre></div>
</div>
</div></blockquote>
</li>
</ul>
<p>把字串 <code class="docutils literal notranslate"><span class="pre">x.c.c</span> <span class="pre">bar.c</span></code> 符合模式 <code class="docutils literal notranslate"><span class="pre">%.c</span></code> 的单词替换成 <code class="docutils literal notranslate"><span class="pre">%.o</span></code> ，返回结果是
<code class="docutils literal notranslate"><span class="pre">x.c.o</span> <span class="pre">bar.o</span></code></p>
<ul>
<li><p>备注：这和我们前面“变量章节”说过的相关知识有点相似。如
<code class="docutils literal notranslate"><span class="pre">$(var:&lt;pattern&gt;=&lt;replacement&gt;;)</span></code> 相当于
<code class="docutils literal notranslate"><span class="pre">$(patsubst</span> <span class="pre">&lt;pattern&gt;,&lt;replacement&gt;,$(var))</span></code> ，而
<code class="docutils literal notranslate"><span class="pre">$(var:</span> <span class="pre">&lt;suffix&gt;=&lt;replacement&gt;)</span></code> 则相当于
<code class="docutils literal notranslate"><span class="pre">$(patsubst</span> <span class="pre">%&lt;suffix&gt;,%&lt;replacement&gt;,$(var))</span></code> 。</p>
<p>例如有:</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span>objects = foo.o bar.o baz.o，
</pre></div>
</div>
<p>那么， <code class="docutils literal notranslate"><span class="pre">$(objects:.o=.c)</span></code> 和 <code class="docutils literal notranslate"><span class="pre">$(patsubst</span> <span class="pre">%.o,%.c,$(objects))</span></code> 是一样的。</p>
</li>
</ul>
</section>
<section id="strip">
<h3>strip<a class="headerlink" href="#strip" title="永久链接至标题"></a></h3>
<div class="highlight-makefile notranslate"><div class="highlight"><pre><span></span><span class="k">$(</span><span class="nv">strip</span> &lt;<span class="nv">string</span>&gt;<span class="k">)</span><span class="w"></span>
</pre></div>
</div>
<ul>
<li><p>名称：去空格函数。</p></li>
<li><p>功能：去掉 <code class="docutils literal notranslate"><span class="pre">&lt;string&gt;</span></code> 字串中开头和结尾的空字符。</p></li>
<li><p>返回：返回被去掉空格的字符串值。</p></li>
<li><p>示例：</p>
<blockquote>
<div><div class="highlight-makefile notranslate"><div class="highlight"><pre><span></span><span class="k">$(</span><span class="nv">strip</span> <span class="nv">a</span> <span class="nv">b</span> <span class="nv">c</span> <span class="k">)</span><span class="w"></span>
</pre></div>
</div>
</div></blockquote>
<p>把字串 <code class="docutils literal notranslate"><span class="pre">a b c&nbsp;</span></code> 去掉开头和结尾的空格，结果是 <code class="docutils literal notranslate"><span class="pre">a</span> <span class="pre">b</span> <span class="pre">c</span></code>。</p>
</li>
</ul>
</section>
<section id="findstring">
<h3>findstring<a class="headerlink" href="#findstring" title="永久链接至标题"></a></h3>
<div class="highlight-makefile notranslate"><div class="highlight"><pre><span></span><span class="k">$(</span><span class="nv">findstring</span> &lt;<span class="nv">find</span>&gt;,&lt;<span class="nv">in</span>&gt;<span class="k">)</span><span class="w"></span>
</pre></div>
</div>
<ul>
<li><p>名称：查找字符串函数</p></li>
<li><p>功能：在字串 <code class="docutils literal notranslate"><span class="pre">&lt;in&gt;</span></code> 中查找 <code class="docutils literal notranslate"><span class="pre">&lt;find&gt;</span></code> 字串。</p></li>
<li><p>返回：如果找到，那么返回 <code class="docutils literal notranslate"><span class="pre">&lt;find&gt;</span></code> ，否则返回空字符串。</p></li>
<li><p>示例：</p>
<blockquote>
<div><div class="highlight-makefile notranslate"><div class="highlight"><pre><span></span><span class="k">$(</span><span class="nv">findstring</span> <span class="nv">a</span>,<span class="nv">a</span> <span class="nv">b</span> <span class="nv">c</span><span class="k">)</span><span class="w"></span>
<span class="k">$(</span><span class="nv">findstring</span> <span class="nv">a</span>,<span class="nv">b</span> <span class="nv">c</span><span class="k">)</span><span class="w"></span>
</pre></div>
</div>
</div></blockquote>
</li>
</ul>
<p>第一个函数返回 <code class="docutils literal notranslate"><span class="pre">a</span></code> 字符串，第二个返回空字符串</p>
</section>
<section id="filter">
<h3>filter<a class="headerlink" href="#filter" title="永久链接至标题"></a></h3>
<div class="highlight-makefile notranslate"><div class="highlight"><pre><span></span><span class="k">$(</span><span class="nv">filter</span> &lt;<span class="nv">pattern...</span>&gt;,&lt;<span class="nv">text</span>&gt;<span class="k">)</span><span class="w"></span>
</pre></div>
</div>
<ul>
<li><p>名称：过滤函数</p></li>
<li><p>功能：以 <code class="docutils literal notranslate"><span class="pre">&lt;pattern&gt;</span></code> 模式过滤 <code class="docutils literal notranslate"><span class="pre">&lt;text&gt;</span></code> 字符串中的单词，保留符合模式
<code class="docutils literal notranslate"><span class="pre">&lt;pattern&gt;</span></code> 的单词。可以有多个模式。</p></li>
<li><p>返回：返回符合模式 <code class="docutils literal notranslate"><span class="pre">&lt;pattern&gt;</span></code> 的字串。</p></li>
<li><p>示例：</p>
<blockquote>
<div><div class="highlight-makefile notranslate"><div class="highlight"><pre><span></span><span class="nv">sources</span> <span class="o">:=</span> foo.c bar.c baz.s ugh.h
<span class="nf">foo</span><span class="o">:</span> <span class="k">$(</span><span class="nv">sources</span><span class="k">)</span>
cc <span class="k">$(</span>filter %.c %.s,<span class="k">$(</span>sources<span class="k">))</span> -o foo
</pre></div>
</div>
</div></blockquote>
<p><code class="docutils literal notranslate"><span class="pre">$(filter</span> <span class="pre">%.c</span> <span class="pre">%.s,$(sources))</span></code> 返回的值是 <code class="docutils literal notranslate"><span class="pre">foo.c</span> <span class="pre">bar.c</span> <span class="pre">baz.s</span></code> 。</p>
</li>
</ul>
</section>
<section id="filter-out">
<h3>filter-out<a class="headerlink" href="#filter-out" title="永久链接至标题"></a></h3>
<div class="highlight-makefile notranslate"><div class="highlight"><pre><span></span><span class="k">$(</span><span class="nv">filter-out</span> &lt;<span class="nv">pattern...</span>&gt;,&lt;<span class="nv">text</span>&gt;<span class="k">)</span><span class="w"></span>
</pre></div>
</div>
<ul>
<li><p>名称：反过滤函数</p></li>
<li><p>功能：以 <code class="docutils literal notranslate"><span class="pre">&lt;pattern&gt;</span></code> 模式过滤 <code class="docutils literal notranslate"><span class="pre">&lt;text&gt;</span></code> 字符串中的单词，去除符合模式
<code class="docutils literal notranslate"><span class="pre">&lt;pattern&gt;</span></code> 的单词。可以有多个模式。</p></li>
<li><p>返回：返回不符合模式 <code class="docutils literal notranslate"><span class="pre">&lt;pattern&gt;</span></code> 的字串。</p></li>
<li><p>示例：</p>
<blockquote>
<div><div class="highlight-makefile notranslate"><div class="highlight"><pre><span></span><span class="nv">objects</span><span class="o">=</span>main1.o foo.o main2.o bar.o
<span class="nv">mains</span><span class="o">=</span>main1.o main2.o
</pre></div>
</div>
</div></blockquote>
<p><code class="docutils literal notranslate"><span class="pre">$(filter-out</span> <span class="pre">$(mains),$(objects))</span></code> 返回值是 <code class="docutils literal notranslate"><span class="pre">foo.o</span> <span class="pre">bar.o</span></code> 。</p>
</li>
</ul>
</section>
<section id="sort">
<h3>sort<a class="headerlink" href="#sort" title="永久链接至标题"></a></h3>
<div class="highlight-makefile notranslate"><div class="highlight"><pre><span></span><span class="k">$(</span><span class="nv">sort</span> &lt;<span class="nv">list</span>&gt;<span class="k">)</span><span class="w"></span>
</pre></div>
</div>
<ul class="simple">
<li><p>名称：排序函数</p></li>
<li><p>功能：给字符串 <code class="docutils literal notranslate"><span class="pre">&lt;list&gt;</span></code> 中的单词排序（升序）。</p></li>
<li><p>返回：返回排序后的字符串。</p></li>
<li><p>示例： <code class="docutils literal notranslate"><span class="pre">$(sort</span> <span class="pre">foo</span> <span class="pre">bar</span> <span class="pre">lose)</span></code> 返回 <code class="docutils literal notranslate"><span class="pre">bar</span> <span class="pre">foo</span> <span class="pre">lose</span></code> 。</p></li>
<li><p>备注： <code class="docutils literal notranslate"><span class="pre">sort</span></code> 函数会去掉 <code class="docutils literal notranslate"><span class="pre">&lt;list&gt;</span></code> 中相同的单词。</p></li>
</ul>
</section>
<section id="word">
<h3>word<a class="headerlink" href="#word" title="永久链接至标题"></a></h3>
<div class="highlight-makefile notranslate"><div class="highlight"><pre><span></span><span class="k">$(</span><span class="nv">word</span> &lt;<span class="nv">n</span>&gt;,&lt;<span class="nv">text</span>&gt;<span class="k">)</span><span class="w"></span>
</pre></div>
</div>
<ul class="simple">
<li><p>名称：取单词函数</p></li>
<li><p>功能：取字符串 <code class="docutils literal notranslate"><span class="pre">&lt;text&gt;</span></code> 中第 <code class="docutils literal notranslate"><span class="pre">&lt;n&gt;</span></code> 个单词。（从一开始）</p></li>
<li><p>返回：返回字符串 <code class="docutils literal notranslate"><span class="pre">&lt;text&gt;</span></code> 中第 <code class="docutils literal notranslate"><span class="pre">&lt;n&gt;</span></code> 个单词。如果 <code class="docutils literal notranslate"><span class="pre">&lt;n&gt;</span></code> 比 <code class="docutils literal notranslate"><span class="pre">&lt;text&gt;</span></code> 中的单词数要大，那么返回空字符串。</p></li>
<li><p>示例： <code class="docutils literal notranslate"><span class="pre">$(word</span> <span class="pre">2,</span> <span class="pre">foo</span> <span class="pre">bar</span> <span class="pre">baz)</span></code> 返回值是 <code class="docutils literal notranslate"><span class="pre">bar</span></code> 。</p></li>
</ul>
</section>
<section id="wordlist">
<h3>wordlist<a class="headerlink" href="#wordlist" title="永久链接至标题"></a></h3>
<div class="highlight-makefile notranslate"><div class="highlight"><pre><span></span><span class="k">$(</span><span class="nv">wordlist</span> &lt;<span class="nv">ss</span>&gt;,&lt;<span class="nv">e</span>&gt;,&lt;<span class="nv">text</span>&gt;<span class="k">)</span><span class="w"></span>
</pre></div>
</div>
<ul class="simple">
<li><p>名称：取单词串函数</p></li>
<li><p>功能：从字符串 <code class="docutils literal notranslate"><span class="pre">&lt;text&gt;</span></code> 中取从 <code class="docutils literal notranslate"><span class="pre">&lt;ss&gt;</span></code> 开始到 <code class="docutils literal notranslate"><span class="pre">&lt;e&gt;</span></code> 的单词串。 <code class="docutils literal notranslate"><span class="pre">&lt;ss&gt;</span></code>
和 <code class="docutils literal notranslate"><span class="pre">&lt;e&gt;</span></code> 是一个数字。</p></li>
<li><p>返回：返回字符串 <code class="docutils literal notranslate"><span class="pre">&lt;text&gt;</span></code> 中从 <code class="docutils literal notranslate"><span class="pre">&lt;ss&gt;</span></code> 到 <code class="docutils literal notranslate"><span class="pre">&lt;e&gt;</span></code> 的单词字串。如果 <code class="docutils literal notranslate"><span class="pre">&lt;ss&gt;</span></code>
比 <code class="docutils literal notranslate"><span class="pre">&lt;text&gt;</span></code> 中的单词数要大，那么返回空字符串。如果 <code class="docutils literal notranslate"><span class="pre">&lt;e&gt;</span></code> 大于 <code class="docutils literal notranslate"><span class="pre">&lt;text&gt;</span></code> 的单词数，那么返回从 <code class="docutils literal notranslate"><span class="pre">&lt;ss&gt;</span></code> 开始，到 <code class="docutils literal notranslate"><span class="pre">&lt;text&gt;</span></code> 结束的单词串。</p></li>
<li><p>示例： <code class="docutils literal notranslate"><span class="pre">$(wordlist</span> <span class="pre">2,</span> <span class="pre">3,</span> <span class="pre">foo</span> <span class="pre">bar</span> <span class="pre">baz)</span></code> 返回值是 <code class="docutils literal notranslate"><span class="pre">bar</span> <span class="pre">baz</span></code> 。</p></li>
</ul>
</section>
<section id="words">
<h3>words<a class="headerlink" href="#words" title="永久链接至标题"></a></h3>
<div class="highlight-makefile notranslate"><div class="highlight"><pre><span></span><span class="k">$(</span><span class="nv">words</span> &lt;<span class="nv">text</span>&gt;<span class="k">)</span><span class="w"></span>
</pre></div>
</div>
<ul class="simple">
<li><p>名称：单词个数统计函数</p></li>
<li><p>功能：统计 <code class="docutils literal notranslate"><span class="pre">&lt;text&gt;</span></code> 中字符串中的单词个数。</p></li>
<li><p>返回：返回 <code class="docutils literal notranslate"><span class="pre">&lt;text&gt;</span></code> 中的单词数。</p></li>
<li><p>示例： <code class="docutils literal notranslate"><span class="pre">$(words,</span> <span class="pre">foo</span> <span class="pre">bar</span> <span class="pre">baz)</span></code> 返回值是 <code class="docutils literal notranslate"><span class="pre">3</span></code> 。</p></li>
<li><p>备注：如果我们要取 <code class="docutils literal notranslate"><span class="pre">&lt;text&gt;</span></code> 中最后的一个单词，我们可以这样：
<code class="docutils literal notranslate"><span class="pre">$(word</span> <span class="pre">$(words</span> <span class="pre">&lt;text&gt;),&lt;text&gt;)</span></code> 。</p></li>
</ul>
</section>
<section id="firstword">
<h3>firstword<a class="headerlink" href="#firstword" title="永久链接至标题"></a></h3>
<div class="highlight-makefile notranslate"><div class="highlight"><pre><span></span><span class="k">$(</span><span class="nv">firstword</span> &lt;<span class="nv">text</span>&gt;<span class="k">)</span><span class="w"></span>
</pre></div>
</div>
<ul class="simple">
<li><p>名称：首单词函数——firstword。</p></li>
<li><p>功能：取字符串 <code class="docutils literal notranslate"><span class="pre">&lt;text&gt;</span></code> 中的第一个单词。</p></li>
<li><p>返回：返回字符串 <code class="docutils literal notranslate"><span class="pre">&lt;text&gt;</span></code> 的第一个单词。</p></li>
<li><p>示例： <code class="docutils literal notranslate"><span class="pre">$(firstword</span> <span class="pre">foo</span> <span class="pre">bar)</span></code> 返回值是 <code class="docutils literal notranslate"><span class="pre">foo</span></code>。</p></li>
<li><p>备注：这个函数可以用 <code class="docutils literal notranslate"><span class="pre">word</span></code> 函数来实现： <code class="docutils literal notranslate"><span class="pre">$(word</span> <span class="pre">1,&lt;text&gt;)</span></code> 。</p></li>
</ul>
<p>以上，是所有的字符串操作函数，如果搭配混合使用，可以完成比较复杂的功能。这里，举一个现实中应用的例子。我们知道，make使用 <code class="docutils literal notranslate"><span class="pre">VPATH</span></code> 变量来指定“依赖文件”的搜索路径。于是，我们可以利用这个搜索路径来指定编译器对头文件的搜索路径参数 <code class="docutils literal notranslate"><span class="pre">CFLAGS</span></code> ，如：</p>
<div class="highlight-makefile notranslate"><div class="highlight"><pre><span></span><span class="nf">override CFLAGS += $(patsubst %,-I%,$(subst </span><span class="o">:</span><span class="p">,</span> <span class="p">,</span><span class="k">$(</span><span class="nv">VPATH</span><span class="k">)</span>))
</pre></div>
</div>
<p>如果我们的 <code class="docutils literal notranslate"><span class="pre">$(VPATH)</span></code> 值是 <code class="docutils literal notranslate"><span class="pre">src:../headers</span></code> ，那么
<code class="docutils literal notranslate"><span class="pre">$(patsubst</span> <span class="pre">%,-I%,$(subst</span> <span class="pre">:,</span> <span class="pre">,$(VPATH)))</span></code> 将返回 <code class="docutils literal notranslate"><span class="pre">-Isrc</span> <span class="pre">-I../headers</span></code> ，这正是cc或gcc搜索头文件路径的参数。</p>
</section>
</section>
<section id="id4">
<h2>文件名操作函数<a class="headerlink" href="#id4" title="永久链接至标题"></a></h2>
<p>下面我们要介绍的函数主要是处理文件名的。每个函数的参数字符串都会被当做一个或是一系列的文件名来对待。</p>
<section id="dir">
<h3>dir<a class="headerlink" href="#dir" title="永久链接至标题"></a></h3>
<div class="highlight-makefile notranslate"><div class="highlight"><pre><span></span><span class="k">$(</span><span class="nv">dir</span> &lt;<span class="nv">names...</span>&gt;<span class="k">)</span><span class="w"></span>
</pre></div>
</div>
<ul class="simple">
<li><p>名称：取目录函数——dir。</p></li>
<li><p>功能：从文件名序列 <code class="docutils literal notranslate"><span class="pre">&lt;names&gt;</span></code> 中取出目录部分。目录部分是指最后一个反斜杠（ <code class="docutils literal notranslate"><span class="pre">/</span></code> ）之前的部分。如果没有反斜杠，那么返回 <code class="docutils literal notranslate"><span class="pre">./</span></code> 。</p></li>
<li><p>返回：返回文件名序列 <code class="docutils literal notranslate"><span class="pre">&lt;names&gt;</span></code> 的目录部分。</p></li>
<li><p>示例： <code class="docutils literal notranslate"><span class="pre">$(dir</span> <span class="pre">src/foo.c</span> <span class="pre">hacks)</span></code> 返回值是 <code class="docutils literal notranslate"><span class="pre">src/</span> <span class="pre">./</span></code> 。</p></li>
</ul>
</section>
<section id="notdir">
<h3>notdir<a class="headerlink" href="#notdir" title="永久链接至标题"></a></h3>
<div class="highlight-makefile notranslate"><div class="highlight"><pre><span></span><span class="k">$(</span><span class="nv">notdir</span> &lt;<span class="nv">names...</span>&gt;<span class="k">)</span><span class="w"></span>
</pre></div>
</div>
<ul class="simple">
<li><p>名称：取文件函数——notdir。</p></li>
<li><p>功能：从文件名序列 <code class="docutils literal notranslate"><span class="pre">&lt;names&gt;</span></code> 中取出非目录部分。非目录部分是指最後一个反斜杠（ <code class="docutils literal notranslate"><span class="pre">/</span></code> ）之后的部分。</p></li>
<li><p>返回：返回文件名序列 <code class="docutils literal notranslate"><span class="pre">&lt;names&gt;</span></code> 的非目录部分。</p></li>
<li><p>示例: <code class="docutils literal notranslate"><span class="pre">$(notdir</span> <span class="pre">src/foo.c</span> <span class="pre">hacks)</span></code> 返回值是 <code class="docutils literal notranslate"><span class="pre">foo.c</span> <span class="pre">hacks</span></code> 。</p></li>
</ul>
</section>
<section id="suffix">
<h3>suffix<a class="headerlink" href="#suffix" title="永久链接至标题"></a></h3>
<div class="highlight-makefile notranslate"><div class="highlight"><pre><span></span><span class="k">$(</span><span class="nv">suffix</span> &lt;<span class="nv">names...</span>&gt;<span class="k">)</span><span class="w"></span>
</pre></div>
</div>
<ul class="simple">
<li><p>名称：取後缀函数——suffix。</p></li>
<li><p>功能：从文件名序列 <code class="docutils literal notranslate"><span class="pre">&lt;names&gt;</span></code> 中取出各个文件名的后缀。</p></li>
<li><p>返回：返回文件名序列 <code class="docutils literal notranslate"><span class="pre">&lt;names&gt;</span></code> 的后缀序列，如果文件没有后缀，则返回空字串。</p></li>
<li><p>示例： <code class="docutils literal notranslate"><span class="pre">$(suffix</span> <span class="pre">src/foo.c</span> <span class="pre">src-1.0/bar.c</span> <span class="pre">hacks)</span></code> 返回值是 <code class="docutils literal notranslate"><span class="pre">.c</span> <span class="pre">.c</span></code>。</p></li>
</ul>
</section>
<section id="basename">
<h3>basename<a class="headerlink" href="#basename" title="永久链接至标题"></a></h3>
<div class="highlight-makefile notranslate"><div class="highlight"><pre><span></span><span class="k">$(</span><span class="nv">basename</span> &lt;<span class="nv">names...</span>&gt;<span class="k">)</span><span class="w"></span>
</pre></div>
</div>
<ul class="simple">
<li><p>名称：取前缀函数——basename。</p></li>
<li><p>功能：从文件名序列 <code class="docutils literal notranslate"><span class="pre">&lt;names&gt;</span></code> 中取出各个文件名的前缀部分。</p></li>
<li><p>返回：返回文件名序列 <code class="docutils literal notranslate"><span class="pre">&lt;names&gt;</span></code> 的前缀序列，如果文件没有前缀，则返回空字串。</p></li>
<li><p>示例： <code class="docutils literal notranslate"><span class="pre">$(basename</span> <span class="pre">src/foo.c</span> <span class="pre">src-1.0/bar.c</span> <span class="pre">hacks)</span></code> 返回值是
<code class="docutils literal notranslate"><span class="pre">src/foo</span> <span class="pre">src-1.0/bar</span> <span class="pre">hacks</span></code> 。</p></li>
</ul>
</section>
<section id="addsuffix">
<h3>addsuffix<a class="headerlink" href="#addsuffix" title="永久链接至标题"></a></h3>
<div class="highlight-makefile notranslate"><div class="highlight"><pre><span></span><span class="k">$(</span><span class="nv">addsuffix</span> &lt;<span class="nv">suffix</span>&gt;,&lt;<span class="nv">names...</span>&gt;<span class="k">)</span><span class="w"></span>
</pre></div>
</div>
<ul class="simple">
<li><p>名称：加后缀函数——addsuffix。</p></li>
<li><p>功能：把后缀 <code class="docutils literal notranslate"><span class="pre">&lt;suffix&gt;</span></code> 加到 <code class="docutils literal notranslate"><span class="pre">&lt;names&gt;</span></code> 中的每个单词后面。</p></li>
<li><p>返回：返回加过后缀的文件名序列。</p></li>
<li><p>示例： <code class="docutils literal notranslate"><span class="pre">$(addsuffix</span> <span class="pre">.c,foo</span> <span class="pre">bar)</span></code> 返回值是 <code class="docutils literal notranslate"><span class="pre">foo.c</span> <span class="pre">bar.c</span></code> 。</p></li>
</ul>
</section>
<section id="addprefix">
<h3>addprefix<a class="headerlink" href="#addprefix" title="永久链接至标题"></a></h3>
<div class="highlight-makefile notranslate"><div class="highlight"><pre><span></span><span class="k">$(</span><span class="nv">addprefix</span> &lt;<span class="nv">prefix</span>&gt;,&lt;<span class="nv">names...</span>&gt;<span class="k">)</span><span class="w"></span>
</pre></div>
</div>
<ul class="simple">
<li><p>名称：加前缀函数——addprefix。</p></li>
<li><p>功能：把前缀 <code class="docutils literal notranslate"><span class="pre">&lt;prefix&gt;</span></code> 加到 <code class="docutils literal notranslate"><span class="pre">&lt;names&gt;</span></code> 中的每个单词前面。</p></li>
<li><p>返回：返回加过前缀的文件名序列。</p></li>
<li><p>示例： <code class="docutils literal notranslate"><span class="pre">$(addprefix</span> <span class="pre">src/,foo</span> <span class="pre">bar)</span></code> 返回值是 <code class="docutils literal notranslate"><span class="pre">src/foo</span> <span class="pre">src/bar</span></code> 。</p></li>
</ul>
</section>
<section id="join">
<h3>join<a class="headerlink" href="#join" title="永久链接至标题"></a></h3>
<div class="highlight-makefile notranslate"><div class="highlight"><pre><span></span><span class="k">$(</span><span class="nv">join</span> &lt;<span class="nv">list1</span>&gt;,&lt;<span class="nv">list2</span>&gt;<span class="k">)</span><span class="w"></span>
</pre></div>
</div>
<ul class="simple">
<li><p>名称：连接函数——join。</p></li>
<li><p>功能：把 <code class="docutils literal notranslate"><span class="pre">&lt;list2&gt;</span></code> 中的单词对应地加到 <code class="docutils literal notranslate"><span class="pre">&lt;list1&gt;</span></code> 的单词后面。如果 <code class="docutils literal notranslate"><span class="pre">&lt;list1&gt;</span></code> 的单词个数要比 <code class="docutils literal notranslate"><span class="pre">&lt;list2&gt;</span></code> 的多，那么， <code class="docutils literal notranslate"><span class="pre">&lt;list1&gt;</span></code> 中的多出来的单词将保持原样。如果
<code class="docutils literal notranslate"><span class="pre">&lt;list2&gt;</span></code> 的单词个数要比 <code class="docutils literal notranslate"><span class="pre">&lt;list1&gt;</span></code> 多，那么， <code class="docutils literal notranslate"><span class="pre">&lt;list2&gt;</span></code> 多出来的单词将被复制到
<code class="docutils literal notranslate"><span class="pre">&lt;list1&gt;</span></code> 中。</p></li>
<li><p>返回：返回连接过后的字符串。</p></li>
<li><p>示例： <code class="docutils literal notranslate"><span class="pre">$(join</span> <span class="pre">aaa</span> <span class="pre">bbb</span> <span class="pre">,</span> <span class="pre">111</span> <span class="pre">222</span> <span class="pre">333)</span></code> 返回值是 <code class="docutils literal notranslate"><span class="pre">aaa111</span> <span class="pre">bbb222</span> <span class="pre">333</span></code> 。</p></li>
</ul>
</section>
</section>
<section id="foreach">
<h2>foreach 函数<a class="headerlink" href="#foreach" title="永久链接至标题"></a></h2>
<p>foreach函数和别的函数非常的不一样。因为这个函数是用来做循环用的，Makefile中的foreach函数几乎是仿照于Unix标准Shell（/bin/sh）中的for语句，或是C-Shell（/bin/csh）中的foreach语句而构建的。它的语法是：</p>
<div class="highlight-makefile notranslate"><div class="highlight"><pre><span></span><span class="k">$(</span><span class="nv">foreach</span> &lt;<span class="nv">var</span>&gt;,&lt;<span class="nv">list</span>&gt;,&lt;<span class="nv">text</span>&gt;<span class="k">)</span><span class="w"></span>
</pre></div>
</div>
<p>这个函数的意思是，把参数 <code class="docutils literal notranslate"><span class="pre">&lt;list&gt;</span></code> 中的单词逐一取出放到参数 <code class="docutils literal notranslate"><span class="pre">&lt;var&gt;</span></code> 所指定的变量中，然后再执行 <code class="docutils literal notranslate"><span class="pre">&lt;text&gt;</span></code> 所包含的表达式。每一次 <code class="docutils literal notranslate"><span class="pre">&lt;text&gt;</span></code> 会返回一个字符串，循环过程中，
<code class="docutils literal notranslate"><span class="pre">&lt;text&gt;</span></code> 的所返回的每个字符串会以空格分隔，最后当整个循环结束时， <code class="docutils literal notranslate"><span class="pre">&lt;text&gt;</span></code> 所返回的每个字符串所组成的整个字符串（以空格分隔）将会是foreach函数的返回值。</p>
<p>所以， <code class="docutils literal notranslate"><span class="pre">&lt;var&gt;</span></code> 最好是一个变量名， <code class="docutils literal notranslate"><span class="pre">&lt;list&gt;</span></code> 可以是一个表达式，而 <code class="docutils literal notranslate"><span class="pre">&lt;text&gt;</span></code> 中一般会使用 <code class="docutils literal notranslate"><span class="pre">&lt;var&gt;</span></code> 这个参数来依次枚举 <code class="docutils literal notranslate"><span class="pre">&lt;list&gt;</span></code> 中的单词。举个例子：</p>
<div class="highlight-makefile notranslate"><div class="highlight"><pre><span></span><span class="nv">names</span> <span class="o">:=</span> a b c d
<span class="nv">files</span> <span class="o">:=</span> <span class="k">$(</span>foreach n,<span class="k">$(</span>names<span class="k">)</span>,<span class="k">$(</span>n<span class="k">)</span>.o<span class="k">)</span>
</pre></div>
</div>
<p>上面的例子中， <code class="docutils literal notranslate"><span class="pre">$(name)</span></code> 中的单词会被挨个取出，并存到变量 <code class="docutils literal notranslate"><span class="pre">n</span></code> 中， <code class="docutils literal notranslate"><span class="pre">$(n).o</span></code> 每次根据 <code class="docutils literal notranslate"><span class="pre">$(n)</span></code> 计算出一个值，这些值以空格分隔，最后作为foreach函数的返回，所以， <code class="docutils literal notranslate"><span class="pre">$(files)</span></code>
的值是 <code class="docutils literal notranslate"><span class="pre">a.o</span> <span class="pre">b.o</span> <span class="pre">c.o</span> <span class="pre">d.o</span></code> 。</p>
<p>注意，foreach中的 <code class="docutils literal notranslate"><span class="pre">&lt;var&gt;</span></code> 参数是一个临时的局部变量，foreach函数执行完后，参数 <code class="docutils literal notranslate"><span class="pre">&lt;var&gt;</span></code>
的变量将不在作用，其作用域只在foreach函数当中。</p>
</section>
<section id="if">
<h2>if 函数<a class="headerlink" href="#if" title="永久链接至标题"></a></h2>
<p>if函数很像GNU的make所支持的条件语句——ifeq（参见前面所述的章节），if函数的语法是：</p>
<div class="highlight-makefile notranslate"><div class="highlight"><pre><span></span><span class="k">$(</span><span class="nv">if</span> &lt;<span class="nv">condition</span>&gt;,&lt;<span class="nv">then-part</span>&gt;<span class="k">)</span><span class="w"></span>
</pre></div>
</div>
<p>或是</p>
<div class="highlight-makefile notranslate"><div class="highlight"><pre><span></span><span class="k">$(</span><span class="nv">if</span> &lt;<span class="nv">condition</span>&gt;,&lt;<span class="nv">then-part</span>&gt;,&lt;<span class="nv">else-part</span>&gt;<span class="k">)</span><span class="w"></span>
</pre></div>
</div>
<p>可见，if函数可以包含“else”部分，或是不含。即if函数的参数可以是两个，也可以是三个。
<code class="docutils literal notranslate"><span class="pre">&lt;condition&gt;</span></code> 参数是if的表达式，如果其返回的为非空字符串，那么这个表达式就相当于返回真，于是， <code class="docutils literal notranslate"><span class="pre">&lt;then-part&gt;</span></code> 会被计算，否则 <code class="docutils literal notranslate"><span class="pre">&lt;else-part&gt;</span></code> 会被计算。</p>
<p>而if函数的返回值是，如果 <code class="docutils literal notranslate"><span class="pre">&lt;condition&gt;</span></code> 为真（非空字符串），那个 <code class="docutils literal notranslate"><span class="pre">&lt;then-part&gt;</span></code>
会是整个函数的返回值，如果 <code class="docutils literal notranslate"><span class="pre">&lt;condition&gt;</span></code> 为假（空字符串），那么 <code class="docutils literal notranslate"><span class="pre">&lt;else-part&gt;</span></code> 会是整个函数的返回值，此时如果 <code class="docutils literal notranslate"><span class="pre">&lt;else-part&gt;</span></code> 没有被定义，那么，整个函数返回空字串。</p>
<p>所以， <code class="docutils literal notranslate"><span class="pre">&lt;then-part&gt;</span></code> 和 <code class="docutils literal notranslate"><span class="pre">&lt;else-part&gt;</span></code> 只会有一个被计算。</p>
</section>
<section id="call">
<h2>call函数<a class="headerlink" href="#call" title="永久链接至标题"></a></h2>
<p>call函数是唯一一个可以用来创建新的参数化的函数。你可以写一个非常复杂的表达式，这个表达式中，你可以定义许多参数，然后你可以call函数来向这个表达式传递参数。其语法是：</p>
<div class="highlight-makefile notranslate"><div class="highlight"><pre><span></span><span class="k">$(</span><span class="nv">call</span> &lt;<span class="nv">expression</span>&gt;,&lt;<span class="nv">parm1</span>&gt;,&lt;<span class="nv">parm2</span>&gt;,<span class="nv">...</span>,&lt;<span class="nv">parmn</span>&gt;<span class="k">)</span><span class="w"></span>
</pre></div>
</div>
<p>当make执行这个函数时， <code class="docutils literal notranslate"><span class="pre">&lt;expression&gt;</span></code> 参数中的变量，如 <code class="docutils literal notranslate"><span class="pre">$(1)</span></code> 、 <code class="docutils literal notranslate"><span class="pre">$(2)</span></code> 等，会被参数 <code class="docutils literal notranslate"><span class="pre">&lt;parm1&gt;</span></code> 、 <code class="docutils literal notranslate"><span class="pre">&lt;parm2&gt;</span></code> 、 <code class="docutils literal notranslate"><span class="pre">&lt;parm3&gt;</span></code> 依次取代。而 <code class="docutils literal notranslate"><span class="pre">&lt;expression&gt;</span></code> 的返回值就是 call 函数的返回值。例如：</p>
<div class="highlight-makefile notranslate"><div class="highlight"><pre><span></span><span class="nv">reverse</span> <span class="o">=</span> <span class="k">$(</span><span class="m">1</span><span class="k">)</span> <span class="k">$(</span><span class="m">2</span><span class="k">)</span>
<span class="nv">foo</span> <span class="o">=</span> <span class="k">$(</span>call reverse,a,b<span class="k">)</span>
</pre></div>
</div>
<p>那么， <code class="docutils literal notranslate"><span class="pre">foo</span></code> 的值就是 <code class="docutils literal notranslate"><span class="pre">a</span> <span class="pre">b</span></code> 。当然，参数的次序是可以自定义的，不一定是顺序的，如：</p>
<div class="highlight-makefile notranslate"><div class="highlight"><pre><span></span><span class="nv">reverse</span> <span class="o">=</span> <span class="k">$(</span><span class="m">2</span><span class="k">)</span> <span class="k">$(</span><span class="m">1</span><span class="k">)</span>
<span class="nv">foo</span> <span class="o">=</span> <span class="k">$(</span>call reverse,a,b<span class="k">)</span>
</pre></div>
</div>
<p>此时的 <code class="docutils literal notranslate"><span class="pre">foo</span></code> 的值就是 <code class="docutils literal notranslate"><span class="pre">b</span> <span class="pre">a</span></code> 。</p>
<p>需要注意：在向 call 函数传递参数时要尤其注意空格的使用。call 函数在处理参数时，第2个及其之后的参数中的空格会被保留，因而可能造成一些奇怪的效果。因而在向call函数提供参数时，最安全的做法是去除所有多余的空格。</p>
</section>
<section id="origin">
<h2>origin函数<a class="headerlink" href="#origin" title="永久链接至标题"></a></h2>
<p>origin函数不像其它的函数，他并不操作变量的值，他只是告诉你你的这个变量是哪里来的？其语法是：</p>
<div class="highlight-makefile notranslate"><div class="highlight"><pre><span></span><span class="k">$(</span><span class="nv">origin</span> &lt;<span class="nv">variable</span>&gt;<span class="k">)</span><span class="w"></span>
</pre></div>
</div>
<dl class="simple">
<dt>注意， <code class="docutils literal notranslate"><span class="pre">&lt;variable&gt;</span></code> 是变量的名字，不应该是引用。所以你最好不要在 <code class="docutils literal notranslate"><span class="pre">&lt;variable&gt;</span></code> 中使用</dt><dd><p><code class="docutils literal notranslate"><span class="pre">$</span></code> 字符。Origin函数会以其返回值来告诉你这个变量的“出生情况”，下面，是origin函数的返回值:</p>
</dd>
<dt><code class="docutils literal notranslate"><span class="pre">undefined</span></code></dt><dd><p>如果 <code class="docutils literal notranslate"><span class="pre">&lt;variable&gt;</span></code> 从来没有定义过，origin函数返回这个值 <code class="docutils literal notranslate"><span class="pre">undefined</span></code></p>
</dd>
<dt><code class="docutils literal notranslate"><span class="pre">default</span></code></dt><dd><p>如果 <code class="docutils literal notranslate"><span class="pre">&lt;variable&gt;</span></code> 是一个默认的定义，比如“CC”这个变量，这种变量我们将在后面讲述。</p>
</dd>
<dt><code class="docutils literal notranslate"><span class="pre">environment</span></code></dt><dd><p>如果 <code class="docutils literal notranslate"><span class="pre">&lt;variable&gt;</span></code> 是一个环境变量，并且当Makefile被执行时， <code class="docutils literal notranslate"><span class="pre">-e</span></code> 参数没有被打开。</p>
</dd>
<dt><code class="docutils literal notranslate"><span class="pre">file</span></code></dt><dd><p>如果 <code class="docutils literal notranslate"><span class="pre">&lt;variable&gt;</span></code> 这个变量被定义在Makefile中。</p>
</dd>
<dt><code class="docutils literal notranslate"><span class="pre">command</span> <span class="pre">line</span></code></dt><dd><p>如果 <code class="docutils literal notranslate"><span class="pre">&lt;variable&gt;</span></code> 这个变量是被命令行定义的。</p>
</dd>
<dt><code class="docutils literal notranslate"><span class="pre">override</span></code></dt><dd><p>如果 <code class="docutils literal notranslate"><span class="pre">&lt;variable&gt;</span></code> 是被override指示符重新定义的。</p>
</dd>
<dt><code class="docutils literal notranslate"><span class="pre">automatic</span></code></dt><dd><p>如果 <code class="docutils literal notranslate"><span class="pre">&lt;variable&gt;</span></code> 是一个命令运行中的自动化变量。关于自动化变量将在后面讲述。</p>
</dd>
</dl>
<p>这些信息对于我们编写Makefile是非常有用的，例如，假设我们有一个Makefile其包了一个定义文件
Make.def，在 Make.def中定义了一个变量“bletch”，而我们的环境中也有一个环境变量“bletch”，此时，我们想判断一下，如果变量来源于环境，那么我们就把之重定义了，如果来源于Make.def或是命令行等非环境的，那么我们就不重新定义它。于是，在我们的Makefile中，我们可以这样写：</p>
<div class="highlight-makefile notranslate"><div class="highlight"><pre><span></span><span class="cp">ifdef bletch</span>
<span class="cp"> ifeq &quot;$(origin bletch)&quot; &quot;environment&quot;</span>
<span class="nv">bletch</span> <span class="o">=</span> barf, gag, etc.
<span class="cp"> endif</span>
<span class="cp">endif</span>
</pre></div>
</div>
<p>当然，你也许会说，使用 <code class="docutils literal notranslate"><span class="pre">override</span></code> 关键字不就可以重新定义环境中的变量了吗？为什么需要使用这样的步骤？是的，我们用 <code class="docutils literal notranslate"><span class="pre">override</span></code> 是可以达到这样的效果，可是 <code class="docutils literal notranslate"><span class="pre">override</span></code> 过于粗暴，它同时会把从命令行定义的变量也覆盖了，而我们只想重新定义环境传来的，而不想重新定义命令行传来的。</p>
</section>
<section id="shell">
<h2>shell函数<a class="headerlink" href="#shell" title="永久链接至标题"></a></h2>
<p>shell函数也不像其它的函数。顾名思义，它的参数应该就是操作系统Shell的命令。它和反引号“`”是相同的功能。这就是说，shell函数把执行操作系统命令后的输出作为函数返回。于是，我们可以用操作系统命令以及字符串处理命令awk，sed等等命令来生成一个变量，如：</p>
<div class="highlight-makefile notranslate"><div class="highlight"><pre><span></span><span class="nv">contents</span> <span class="o">:=</span> <span class="k">$(</span>shell cat foo<span class="k">)</span>
<span class="nv">files</span> <span class="o">:=</span> <span class="k">$(</span>shell <span class="nb">echo</span> *.c<span class="k">)</span>
</pre></div>
</div>
<p>注意，这个函数会新生成一个Shell程序来执行命令，所以你要注意其运行性能，如果你的Makefile中有一些比较复杂的规则，并大量使用了这个函数，那么对于你的系统性能是有害的。特别是Makefile的隐晦的规则可能会让你的shell函数执行的次数比你想像的多得多。</p>
</section>
<section id="make">
<h2>控制make的函数<a class="headerlink" href="#make" title="永久链接至标题"></a></h2>
<p>make提供了一些函数来控制make的运行。通常，你需要检测一些运行Makefile时的运行时信息，并且根据这些信息来决定，你是让make继续执行，还是停止。</p>
<div class="highlight-makefile notranslate"><div class="highlight"><pre><span></span><span class="k">$(</span><span class="nv">error</span> &lt;<span class="nv">text</span> <span class="nv">...</span>&gt;<span class="k">)</span><span class="w"></span>
</pre></div>
</div>
<p>产生一个致命的错误， <code class="docutils literal notranslate"><span class="pre">&lt;text</span> <span class="pre">...&gt;</span></code> 是错误信息。注意，error函数不会在一被使用就会产生错误信息，所以如果你把其定义在某个变量中，并在后续的脚本中使用这个变量，那么也是可以的。例如：</p>
<p>示例一：</p>
<div class="highlight-makefile notranslate"><div class="highlight"><pre><span></span><span class="cp">ifdef ERROR_001</span>
<span class="k">$(</span>error error is <span class="k">$(</span>ERROR_001<span class="k">))</span>
<span class="cp">endif</span>
</pre></div>
</div>
<p>示例二：</p>
<div class="highlight-makefile notranslate"><div class="highlight"><pre><span></span><span class="nv">ERR</span> <span class="o">=</span> <span class="k">$(</span>error found an error!<span class="k">)</span>
<span class="nf">.PHONY</span><span class="o">:</span> <span class="n">err</span>
<span class="nf">err</span><span class="o">:</span> <span class="k">$(</span><span class="nv">ERR</span><span class="k">)</span>
</pre></div>
</div>
<p>示例一会在变量ERROR_001定义了后执行时产生error调用，而示例二则在目录err被执行时才发生error调用。</p>
<div class="highlight-makefile notranslate"><div class="highlight"><pre><span></span><span class="k">$(</span><span class="nv">warning</span> &lt;<span class="nv">text</span> <span class="nv">...</span>&gt;<span class="k">)</span><span class="w"></span>
</pre></div>
</div>
<p>这个函数很像error函数，只是它并不会让make退出，只是输出一段警告信息，而make继续执行。</p>
</section>
</section>
</div>
</div>
<footer><div class="rst-footer-buttons" role="navigation" aria-label="Footer">
<a href="conditionals.html" class="btn btn-neutral float-left" title="使用条件判断" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
<a href="invoke.html" class="btn btn-neutral float-right" title="make 的运行" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
</div>
<hr/>
<div role="contentinfo">
<p>&#169; 版权所有 2014-2019, 作者：陈皓；排版：SeisMan.
<span class="lastupdated">最后更新于 2022年5月22日.
</span></p>
</div>
Built with <a href="https://www.sphinx-doc.org/">Sphinx</a> using a
<a href="https://github.com/readthedocs/sphinx_rtd_theme">theme</a>
provided by <a href="https://readthedocs.org">Read the Docs</a>.
</footer>
</div>
</div>
</section>
</div>
<script>
jQuery(function () {
SphinxRtdTheme.Navigation.enable(true);
});
</script>
</body>
</html>

116
genindex.html Normal file
View File

@ -0,0 +1,116 @@
<!DOCTYPE html>
<html class="writer-html5" lang="zh-CN" >
<head>
<meta charset="utf-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<title>索引 &mdash; 跟我一起写Makefile 1.0 文档</title>
<link rel="stylesheet" href="_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="_static/css/theme.css" type="text/css" />
<!--[if lt IE 9]>
<script src="_static/js/html5shiv.min.js"></script>
<![endif]-->
<script data-url_root="./" id="documentation_options" src="_static/documentation_options.js"></script>
<script src="_static/jquery.js"></script>
<script src="_static/underscore.js"></script>
<script src="_static/doctools.js"></script>
<script src="_static/translations.js"></script>
<script src="_static/js/theme.js"></script>
<link rel="index" title="索引" href="#" />
<link rel="search" title="搜索" href="search.html" />
</head>
<body class="wy-body-for-nav">
<div class="wy-grid-for-nav">
<nav data-toggle="wy-nav-shift" class="wy-nav-side">
<div class="wy-side-scroll">
<div class="wy-side-nav-search" >
<a href="index.html" class="icon icon-home"> 跟我一起写Makefile
</a>
<div class="version">
1.0
</div>
<div role="search">
<form id="rtd-search-form" class="wy-form" action="search.html" method="get">
<input type="text" name="q" placeholder="Search docs" />
<input type="hidden" name="check_keywords" value="yes" />
<input type="hidden" name="area" value="default" />
</form>
</div>
</div><div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="Navigation menu">
<p class="caption" role="heading"><span class="caption-text">目录</span></p>
<ul>
<li class="toctree-l1"><a class="reference internal" href="overview.html">概述</a></li>
<li class="toctree-l1"><a class="reference internal" href="introduction.html">makefile介绍</a></li>
<li class="toctree-l1"><a class="reference internal" href="rules.html">书写规则</a></li>
<li class="toctree-l1"><a class="reference internal" href="recipes.html">书写命令</a></li>
<li class="toctree-l1"><a class="reference internal" href="variables.html">使用变量</a></li>
<li class="toctree-l1"><a class="reference internal" href="conditionals.html">使用条件判断</a></li>
<li class="toctree-l1"><a class="reference internal" href="functions.html">使用函数</a></li>
<li class="toctree-l1"><a class="reference internal" href="invoke.html">make 的运行</a></li>
<li class="toctree-l1"><a class="reference internal" href="implicit_rules.html">隐含规则</a></li>
<li class="toctree-l1"><a class="reference internal" href="archives.html">使用make更新函数库文件</a></li>
<li class="toctree-l1"><a class="reference internal" href="postscript.html">后序</a></li>
</ul>
</div>
</div>
</nav>
<section data-toggle="wy-nav-shift" class="wy-nav-content-wrap"><nav class="wy-nav-top" aria-label="Mobile navigation menu" >
<i data-toggle="wy-nav-top" class="fa fa-bars"></i>
<a href="index.html">跟我一起写Makefile</a>
</nav>
<div class="wy-nav-content">
<div class="rst-content">
<div role="navigation" aria-label="Page navigation">
<ul class="wy-breadcrumbs">
<li><a href="index.html" class="icon icon-home"></a> &raquo;</li>
<li>索引</li>
<li class="wy-breadcrumbs-aside">
</li>
</ul>
<hr/>
</div>
<div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
<div itemprop="articleBody">
<h1 id="index">索引</h1>
<div class="genindex-jumpbox">
</div>
</div>
</div>
<footer>
<hr/>
<div role="contentinfo">
<p>&#169; 版权所有 2014-2019, 作者：陈皓；排版：SeisMan.
<span class="lastupdated">最后更新于 2022年5月22日.
</span></p>
</div>
Built with <a href="https://www.sphinx-doc.org/">Sphinx</a> using a
<a href="https://github.com/readthedocs/sphinx_rtd_theme">theme</a>
provided by <a href="https://readthedocs.org">Read the Docs</a>.
</footer>
</div>
</div>
</section>
</div>
<script>
jQuery(function () {
SphinxRtdTheme.Navigation.enable(true);
});
</script>
</body>
</html>

474
implicit_rules.html Normal file
View File

@ -0,0 +1,474 @@
<!DOCTYPE html>
<html class="writer-html5" lang="zh-CN" >
<head>
<meta charset="utf-8" /><meta name="generator" content="Docutils 0.17.1: http://docutils.sourceforge.net/" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<title>隐含规则 &mdash; 跟我一起写Makefile 1.0 文档</title>
<link rel="stylesheet" href="_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="_static/css/theme.css" type="text/css" />
<!--[if lt IE 9]>
<script src="_static/js/html5shiv.min.js"></script>
<![endif]-->
<script data-url_root="./" id="documentation_options" src="_static/documentation_options.js"></script>
<script src="_static/jquery.js"></script>
<script src="_static/underscore.js"></script>
<script src="_static/doctools.js"></script>
<script src="_static/translations.js"></script>
<script src="_static/js/theme.js"></script>
<link rel="index" title="索引" href="genindex.html" />
<link rel="search" title="搜索" href="search.html" />
<link rel="next" title="使用make更新函数库文件" href="archives.html" />
<link rel="prev" title="make 的运行" href="invoke.html" />
</head>
<body class="wy-body-for-nav">
<div class="wy-grid-for-nav">
<nav data-toggle="wy-nav-shift" class="wy-nav-side">
<div class="wy-side-scroll">
<div class="wy-side-nav-search" >
<a href="index.html" class="icon icon-home"> 跟我一起写Makefile
</a>
<div class="version">
1.0
</div>
<div role="search">
<form id="rtd-search-form" class="wy-form" action="search.html" method="get">
<input type="text" name="q" placeholder="Search docs" />
<input type="hidden" name="check_keywords" value="yes" />
<input type="hidden" name="area" value="default" />
</form>
</div>
</div><div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="Navigation menu">
<p class="caption" role="heading"><span class="caption-text">目录</span></p>
<ul class="current">
<li class="toctree-l1"><a class="reference internal" href="overview.html">概述</a></li>
<li class="toctree-l1"><a class="reference internal" href="introduction.html">makefile介绍</a></li>
<li class="toctree-l1"><a class="reference internal" href="rules.html">书写规则</a></li>
<li class="toctree-l1"><a class="reference internal" href="recipes.html">书写命令</a></li>
<li class="toctree-l1"><a class="reference internal" href="variables.html">使用变量</a></li>
<li class="toctree-l1"><a class="reference internal" href="conditionals.html">使用条件判断</a></li>
<li class="toctree-l1"><a class="reference internal" href="functions.html">使用函数</a></li>
<li class="toctree-l1"><a class="reference internal" href="invoke.html">make 的运行</a></li>
<li class="toctree-l1 current"><a class="current reference internal" href="#">隐含规则</a><ul>
<li class="toctree-l2"><a class="reference internal" href="#id2">使用隐含规则</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id3">隐含规则一览</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id4">隐含规则使用的变量</a><ul>
<li class="toctree-l3"><a class="reference internal" href="#id5">关于命令的变量。</a></li>
<li class="toctree-l3"><a class="reference internal" href="#id6">关于命令参数的变量</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="#id7">隐含规则链</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id8">定义模式规则</a><ul>
<li class="toctree-l3"><a class="reference internal" href="#id9">模式规则介绍</a></li>
<li class="toctree-l3"><a class="reference internal" href="#id10">模式规则示例</a></li>
<li class="toctree-l3"><a class="reference internal" href="#id11">自动化变量</a></li>
<li class="toctree-l3"><a class="reference internal" href="#id12">模式的匹配</a></li>
<li class="toctree-l3"><a class="reference internal" href="#id13">重载内建隐含规则</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="#id14">老式风格的“后缀规则”</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id15">隐含规则搜索算法</a></li>
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="archives.html">使用make更新函数库文件</a></li>
<li class="toctree-l1"><a class="reference internal" href="postscript.html">后序</a></li>
</ul>
</div>
</div>
</nav>
<section data-toggle="wy-nav-shift" class="wy-nav-content-wrap"><nav class="wy-nav-top" aria-label="Mobile navigation menu" >
<i data-toggle="wy-nav-top" class="fa fa-bars"></i>
<a href="index.html">跟我一起写Makefile</a>
</nav>
<div class="wy-nav-content">
<div class="rst-content">
<div role="navigation" aria-label="Page navigation">
<ul class="wy-breadcrumbs">
<li><a href="index.html" class="icon icon-home"></a> &raquo;</li>
<li>隐含规则</li>
<li class="wy-breadcrumbs-aside">
<a href="_sources/implicit_rules.rst.txt" rel="nofollow"> View page source</a>
</li>
</ul>
<hr/>
</div>
<div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
<div itemprop="articleBody">
<section id="id1">
<h1>隐含规则<a class="headerlink" href="#id1" title="永久链接至标题"></a></h1>
<p>在我们使用Makefile时，有一些我们会经常使用，而且使用频率非常高的东西，比如，我们编译C/C++的源程序为中间目标文件（Unix下是 <code class="docutils literal notranslate"><span class="pre">.o</span></code> 文件，Windows下是 <code class="docutils literal notranslate"><span class="pre">.obj</span></code> 文件）。本章讲述的就是一些在Makefile中的“隐含的”，早先约定了的，不需要我们再写出来的规则。</p>
<p>“隐含规则”也就是一种惯例，make会按照这种“惯例”心照不喧地来运行，那怕我们的Makefile中没有书写这样的规则。例如，把 <code class="docutils literal notranslate"><span class="pre">.c</span></code> 文件编译成 <code class="docutils literal notranslate"><span class="pre">.o</span></code> 文件这一规则，你根本就不用写出来，make会自动推导出这种规则，并生成我们需要的 <code class="docutils literal notranslate"><span class="pre">.o</span></code> 文件。</p>
<p>“隐含规则”会使用一些我们系统变量，我们可以改变这些系统变量的值来定制隐含规则的运行时的参数。如系统变量 <code class="docutils literal notranslate"><span class="pre">CFLAGS</span></code> 可以控制编译时的编译器参数。</p>
<p>我们还可以通过“模式规则”的方式写下自己的隐含规则。用“后缀规则”来定义隐含规则会有许多的限制。使用“模式规则”会更回得智能和清楚，但“后缀规则”可以用来保证我们Makefile的兼容性。我们了解了“隐含规则”，可以让其为我们更好的服务，也会让我们知道一些“约定俗成”了的东西，而不至于使得我们在运行Makefile时出现一些我们觉得莫名其妙的东西。当然，任何事物都是矛盾的，水能载舟，亦可覆舟，所以，有时候“隐含规则”也会给我们造成不小的麻烦。只有了解了它，我们才能更好地使用它。</p>
<section id="id2">
<h2>使用隐含规则<a class="headerlink" href="#id2" title="永久链接至标题"></a></h2>
<p>如果要使用隐含规则生成你需要的目标，你所需要做的就是不要写出这个目标的规则。那么，make会试图去自动推导产生这个目标的规则和命令，如果 make可以自动推导生成这个目标的规则和命令，那么这个行为就是隐含规则的自动推导。当然，隐含规则是make事先约定好的一些东西。例如，我们有下面的一个Makefile：</p>
<div class="highlight-makefile notranslate"><div class="highlight"><pre><span></span><span class="nf">foo </span><span class="o">:</span> <span class="n">foo</span>.<span class="n">o</span> <span class="n">bar</span>.<span class="n">o</span>
cc –o foo foo.o bar.o <span class="k">$(</span>CFLAGS<span class="k">)</span> <span class="k">$(</span>LDFLAGS<span class="k">)</span>
</pre></div>
</div>
<p>我们可以注意到，这个Makefile中并没有写下如何生成 <code class="docutils literal notranslate"><span class="pre">foo.o</span></code> 和 <code class="docutils literal notranslate"><span class="pre">bar.o</span></code> 这两目标的规则和命令。因为make的“隐含规则”功能会自动为我们自动去推导这两个目标的依赖目标和生成命令。</p>
<p>make会在自己的“隐含规则”库中寻找可以用的规则，如果找到，那么就会使用。如果找不到，那么就会报错。在上面的那个例子中，make调用的隐含规则是，把 <code class="docutils literal notranslate"><span class="pre">.o</span></code> 的目标的依赖文件置成 <code class="docutils literal notranslate"><span class="pre">.c</span></code> ，并使用C的编译命令 <code class="docutils literal notranslate"><span class="pre">cc</span> <span class="pre">–c</span> <span class="pre">$(CFLAGS)</span>&#160; <span class="pre">foo.c</span></code> 来生成 <code class="docutils literal notranslate"><span class="pre">foo.o</span></code> 的目标。也就是说，我们完全没有必要写下下面的两条规则：</p>
<div class="highlight-makefile notranslate"><div class="highlight"><pre><span></span><span class="nf">foo.o </span><span class="o">:</span> <span class="n">foo</span>.<span class="n">c</span>
cc –c foo.c <span class="k">$(</span>CFLAGS<span class="k">)</span>
<span class="nf">bar.o </span><span class="o">:</span> <span class="n">bar</span>.<span class="n">c</span>
cc –c bar.c <span class="k">$(</span>CFLAGS<span class="k">)</span>
</pre></div>
</div>
<p>因为，这已经是“约定”好了的事了，make和我们约定好了用C编译器 <code class="docutils literal notranslate"><span class="pre">cc</span></code> 生成 <code class="docutils literal notranslate"><span class="pre">.o</span></code> 文件的规则，这就是隐含规则。</p>
<p>当然，如果我们为 <code class="docutils literal notranslate"><span class="pre">.o</span></code> 文件书写了自己的规则，那么make就不会自动推导并调用隐含规则，它会按照我们写好的规则忠实地执行。</p>
<p>还有，在make的“隐含规则库”中，每一条隐含规则都在库中有其顺序，越靠前的则是越被经常使用的，所以，这会导致我们有些时候即使我们显示地指定了目标依赖，make也不会管。如下面这条规则（没有命令）：</p>
<div class="highlight-makefile notranslate"><div class="highlight"><pre><span></span><span class="nf">foo.o </span><span class="o">:</span> <span class="n">foo</span>.<span class="n">p</span>
</pre></div>
</div>
<p>依赖文件 <code class="docutils literal notranslate"><span class="pre">foo.p</span></code> （Pascal程序的源文件）有可能变得没有意义。如果目录下存在了 <code class="docutils literal notranslate"><span class="pre">foo.c</span></code> 文件，那么我们的隐含规则一样会生效，并会通过 <code class="docutils literal notranslate"><span class="pre">foo.c</span></code> 调用C的编译器生成 <code class="docutils literal notranslate"><span class="pre">foo.o</span></code> 文件。因为，在隐含规则中，Pascal的规则出现在C的规则之后，所以，make找到可以生成 <code class="docutils literal notranslate"><span class="pre">foo.o</span></code> 的C的规则就不再寻找下一条规则了。如果你确实不希望任何隐含规则推导，那么，你就不要只写出“依赖规则”，而不写命令。</p>
</section>
<section id="id3">
<h2>隐含规则一览<a class="headerlink" href="#id3" title="永久链接至标题"></a></h2>
<p>这里我们将讲述所有预先设置（也就是make内建）的隐含规则，如果我们不明确地写下规则，那么，make就会在这些规则中寻找所需要规则和命令。当然，我们也可以使用make的参数 <code class="docutils literal notranslate"><span class="pre">-r</span></code> 或 <code class="docutils literal notranslate"><span class="pre">--no-builtin-rules</span></code>
选项来取消所有的预设置的隐含规则。</p>
<p>当然，即使是我们指定了 <code class="docutils literal notranslate"><span class="pre">-r</span></code> 参数，某些隐含规则还是会生效，因为有许多的隐含规则都是使用了“后缀规则”来定义的，所以，只要隐含规则中有 “后缀列表”（也就一系统定义在目标 <code class="docutils literal notranslate"><span class="pre">.SUFFIXES</span></code>
的依赖目标），那么隐含规则就会生效。默认的后缀列表是：.out, .a, .ln, .o, .c, .cc, .C, .p, .f, .F, .r, .y, .l, .s, .S, .mod, .sym,
.def, .h, .info, .dvi, .tex, .texinfo, .texi, .txinfo, .w, .ch .web, .sh, .elc, .el。具体的细节，我们会在后面讲述。</p>
<p>还是先来看一看常用的隐含规则吧。</p>
<ol class="arabic">
<li><p>编译C程序的隐含规则。</p>
<p><code class="docutils literal notranslate"><span class="pre">&lt;n&gt;.o</span></code> 的目标的依赖目标会自动推导为 <code class="docutils literal notranslate"><span class="pre">&lt;n&gt;.c</span></code> ，并且其生成命令是 <code class="docutils literal notranslate"><span class="pre">$(CC)</span> <span class="pre">–c</span> <span class="pre">$(CPPFLAGS)</span> <span class="pre">$(CFLAGS)</span></code></p>
</li>
<li><p>编译C++程序的隐含规则。</p>
<p><code class="docutils literal notranslate"><span class="pre">&lt;n&gt;.o</span></code> 的目标的依赖目标会自动推导为 <code class="docutils literal notranslate"><span class="pre">&lt;n&gt;.cc</span></code> 或是 <code class="docutils literal notranslate"><span class="pre">&lt;n&gt;.C</span></code> ，并且其生成命令是
<code class="docutils literal notranslate"><span class="pre">$(CXX)</span> <span class="pre">–c</span> <span class="pre">$(CPPFLAGS)</span> <span class="pre">$(CXXFLAGS)</span></code> 。（建议使用 <code class="docutils literal notranslate"><span class="pre">.cc</span></code> 作为C++源文件的后缀，而不是 <code class="docutils literal notranslate"><span class="pre">.C</span></code> ）</p>
</li>
<li><p>编译Pascal程序的隐含规则。</p>
<p><code class="docutils literal notranslate"><span class="pre">&lt;n&gt;.o</span></code> 的目标的依赖目标会自动推导为 <code class="docutils literal notranslate"><span class="pre">&lt;n&gt;.p</span></code> ，并且其生成命令是 <code class="docutils literal notranslate"><span class="pre">$(PC)</span> <span class="pre">–c</span>&#160; <span class="pre">$(PFLAGS)</span></code> 。</p>
</li>
<li><p>编译Fortran/Ratfor程序的隐含规则。</p>
<p><code class="docutils literal notranslate"><span class="pre">&lt;n&gt;.o</span></code> 的目标的依赖目标会自动推导为 <code class="docutils literal notranslate"><span class="pre">&lt;n&gt;.r</span></code> 或 <code class="docutils literal notranslate"><span class="pre">&lt;n&gt;.F</span></code> 或 <code class="docutils literal notranslate"><span class="pre">&lt;n&gt;.f</span></code> ，并且其生成命令是:</p>
<ul class="simple">
<li><p><code class="docutils literal notranslate"><span class="pre">.f</span></code> <code class="docutils literal notranslate"><span class="pre">$(FC)</span> <span class="pre">–c</span>&#160; <span class="pre">$(FFLAGS)</span></code></p></li>
<li><p><code class="docutils literal notranslate"><span class="pre">.F</span></code> <code class="docutils literal notranslate"><span class="pre">$(FC)</span> <span class="pre">–c</span>&#160; <span class="pre">$(FFLAGS)</span> <span class="pre">$(CPPFLAGS)</span></code></p></li>
<li><p><code class="docutils literal notranslate"><span class="pre">.f</span></code> <code class="docutils literal notranslate"><span class="pre">$(FC)</span> <span class="pre">–c</span>&#160; <span class="pre">$(FFLAGS)</span> <span class="pre">$(RFLAGS)</span></code></p></li>
</ul>
</li>
<li><p>预处理Fortran/Ratfor程序的隐含规则。</p>
<p><code class="docutils literal notranslate"><span class="pre">&lt;n&gt;.f</span></code> 的目标的依赖目标会自动推导为 <code class="docutils literal notranslate"><span class="pre">&lt;n&gt;.r</span></code> 或 <code class="docutils literal notranslate"><span class="pre">&lt;n&gt;.F</span></code> 。这个规则只是转换Ratfor
或有预处理的Fortran程序到一个标准的Fortran程序。其使用的命令是：</p>
<ul class="simple">
<li><p><code class="docutils literal notranslate"><span class="pre">.F</span></code> <code class="docutils literal notranslate"><span class="pre">$(FC)</span> <span class="pre">–F</span> <span class="pre">$(CPPFLAGS)</span> <span class="pre">$(FFLAGS)</span></code></p></li>
<li><p><code class="docutils literal notranslate"><span class="pre">.r</span></code> <code class="docutils literal notranslate"><span class="pre">$(FC)</span> <span class="pre">–F</span> <span class="pre">$(FFLAGS)</span> <span class="pre">$(RFLAGS)</span></code></p></li>
</ul>
</li>
<li><p>编译Modula-2程序的隐含规则。</p>
<p><code class="docutils literal notranslate"><span class="pre">&lt;n&gt;.sym</span></code> 的目标的依赖目标会自动推导为 <code class="docutils literal notranslate"><span class="pre">&lt;n&gt;.def</span></code> ，并且其生成命令是：
<code class="docutils literal notranslate"><span class="pre">$(M2C)</span> <span class="pre">$(M2FLAGS)</span> <span class="pre">$(DEFFLAGS)</span></code> 。 <code class="docutils literal notranslate"><span class="pre">&lt;n&gt;.o</span></code> 的目标的依赖目标会自动推导为 <code class="docutils literal notranslate"><span class="pre">&lt;n&gt;.mod</span></code> ，并且其生成命令是： <code class="docutils literal notranslate"><span class="pre">$(M2C)</span> <span class="pre">$(M2FLAGS)</span> <span class="pre">$(MODFLAGS)</span></code> 。</p>
</li>
<li><p>汇编和汇编预处理的隐含规则。</p>
<p><code class="docutils literal notranslate"><span class="pre">&lt;n&gt;.o</span></code> 的目标的依赖目标会自动推导为 <code class="docutils literal notranslate"><span class="pre">&lt;n&gt;.s</span></code> ，默认使用编译器 <code class="docutils literal notranslate"><span class="pre">as</span></code> ，并且其生成命令是： <code class="docutils literal notranslate"><span class="pre">$</span> <span class="pre">(AS)</span> <span class="pre">$(ASFLAGS)</span></code> 。 <code class="docutils literal notranslate"><span class="pre">&lt;n&gt;.s</span></code> 的目标的依赖目标会自动推导为 <code class="docutils literal notranslate"><span class="pre">&lt;n&gt;.S</span></code> ，默认使用C预编译器 <code class="docutils literal notranslate"><span class="pre">cpp</span></code> ，并且其生成命令是： <code class="docutils literal notranslate"><span class="pre">$(AS)</span> <span class="pre">$(ASFLAGS)</span></code> 。</p>
</li>
<li><p>链接Object文件的隐含规则。</p>
<p><code class="docutils literal notranslate"><span class="pre">&lt;n&gt;</span></code> 目标依赖于 <code class="docutils literal notranslate"><span class="pre">&lt;n&gt;.o</span></code> ，通过运行C的编译器来运行链接程序生成（一般是 <code class="docutils literal notranslate"><span class="pre">ld</span></code> ），其生成命令是： <code class="docutils literal notranslate"><span class="pre">$(CC)</span> <span class="pre">$(LDFLAGS)</span> <span class="pre">&lt;n&gt;.o</span> <span class="pre">$(LOADLIBES)</span> <span class="pre">$(LDLIBS)</span></code> 。这个规则对于只有一个源文件的工程有效，同时也对多个Object文件（由不同的源文件生成）的也有效。例如如下规则:</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">x</span> <span class="p">:</span> <span class="n">y</span><span class="o">.</span><span class="n">o</span> <span class="n">z</span><span class="o">.</span><span class="n">o</span>
</pre></div>
</div>
<p>并且 <code class="docutils literal notranslate"><span class="pre">x.c</span></code> 、 <code class="docutils literal notranslate"><span class="pre">y.c</span></code> 和 <code class="docutils literal notranslate"><span class="pre">z.c</span></code> 都存在时，隐含规则将执行如下命令:</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">cc</span> <span class="o">-</span><span class="n">c</span> <span class="n">x</span><span class="o">.</span><span class="n">c</span> <span class="o">-</span><span class="n">o</span> <span class="n">x</span><span class="o">.</span><span class="n">o</span>
<span class="n">cc</span> <span class="o">-</span><span class="n">c</span> <span class="n">y</span><span class="o">.</span><span class="n">c</span> <span class="o">-</span><span class="n">o</span> <span class="n">y</span><span class="o">.</span><span class="n">o</span>
<span class="n">cc</span> <span class="o">-</span><span class="n">c</span> <span class="n">z</span><span class="o">.</span><span class="n">c</span> <span class="o">-</span><span class="n">o</span> <span class="n">z</span><span class="o">.</span><span class="n">o</span>
<span class="n">cc</span> <span class="n">x</span><span class="o">.</span><span class="n">o</span> <span class="n">y</span><span class="o">.</span><span class="n">o</span> <span class="n">z</span><span class="o">.</span><span class="n">o</span> <span class="o">-</span><span class="n">o</span> <span class="n">x</span>
<span class="n">rm</span> <span class="o">-</span><span class="n">f</span> <span class="n">x</span><span class="o">.</span><span class="n">o</span>
<span class="n">rm</span> <span class="o">-</span><span class="n">f</span> <span class="n">y</span><span class="o">.</span><span class="n">o</span>
<span class="n">rm</span> <span class="o">-</span><span class="n">f</span> <span class="n">z</span><span class="o">.</span><span class="n">o</span>
</pre></div>
</div>
<p>如果没有一个源文件（如上例中的x.c）和你的目标名字（如上例中的x）相关联，那么，你最好写出自己的生成规则，不然，隐含规则会报错的。</p>
</li>
<li><p>Yacc C程序时的隐含规则。</p>
<p><code class="docutils literal notranslate"><span class="pre">&lt;n&gt;.c</span></code> 的依赖文件被自动推导为 <code class="docutils literal notranslate"><span class="pre">n.y</span></code> （Yacc生成的文件），其生成命令是： <code class="docutils literal notranslate"><span class="pre">$(YACC)</span> <span class="pre">$(YFALGS)</span></code> 。（“Yacc”是一个语法分析器，关于其细节请查看相关资料）</p>
</li>
<li><p>Lex C程序时的隐含规则。</p>
<p><code class="docutils literal notranslate"><span class="pre">&lt;n&gt;.c</span></code> 的依赖文件被自动推导为 <code class="docutils literal notranslate"><span class="pre">n.l</span></code> （Lex生成的文件），其生成命令是： <code class="docutils literal notranslate"><span class="pre">$(LEX)</span> <span class="pre">$(LFALGS)</span></code> 。（关于“Lex”的细节请查看相关资料）</p>
</li>
<li><p>Lex Ratfor程序时的隐含规则。</p>
<p><code class="docutils literal notranslate"><span class="pre">&lt;n&gt;.r</span></code> 的依赖文件被自动推导为 <code class="docutils literal notranslate"><span class="pre">n.l</span></code> （Lex生成的文件），其生成命令是： <code class="docutils literal notranslate"><span class="pre">$(LEX)</span> <span class="pre">$(LFALGS)</span></code> 。</p>
</li>
<li><p>从C程序、Yacc文件或Lex文件创建Lint库的隐含规则。</p>
<p><code class="docutils literal notranslate"><span class="pre">&lt;n&gt;.ln</span></code> （lint生成的文件）的依赖文件被自动推导为 <code class="docutils literal notranslate"><span class="pre">n.c</span></code> ，其生成命令是：
<code class="docutils literal notranslate"><span class="pre">$(LINT)</span> <span class="pre">$(LINTFALGS)</span> <span class="pre">$(CPPFLAGS)</span> <span class="pre">-i</span></code> 。对于 <code class="docutils literal notranslate"><span class="pre">&lt;n&gt;.y</span></code> 和 <code class="docutils literal notranslate"><span class="pre">&lt;n&gt;.l</span></code> 也是同样的规则。</p>
</li>
</ol>
</section>
<section id="id4">
<h2>隐含规则使用的变量<a class="headerlink" href="#id4" title="永久链接至标题"></a></h2>
<p>在隐含规则中的命令中，基本上都是使用了一些预先设置的变量。你可以在你的makefile中改变这些变量的值，或是在make的命令行中传入这些值，或是在你的环境变量中设置这些值，无论怎么样，只要设置了这些特定的变量，那么其就会对隐含规则起作用。当然，你也可以利用make的 <code class="docutils literal notranslate"><span class="pre">-R</span></code> 或 <code class="docutils literal notranslate"><span class="pre">--no–builtin-variables</span></code>
参数来取消你所定义的变量对隐含规则的作用。</p>
<p>例如，第一条隐含规则——编译C程序的隐含规则的命令是 <code class="docutils literal notranslate"><span class="pre">$(CC)</span> <span class="pre">–c</span> <span class="pre">$(CFLAGS)</span> <span class="pre">$(CPPFLAGS)</span></code> 。Make默认的编译命令是 <code class="docutils literal notranslate"><span class="pre">cc</span></code> ，如果你把变量 <code class="docutils literal notranslate"><span class="pre">$(CC)</span></code> 重定义成 <code class="docutils literal notranslate"><span class="pre">gcc</span></code> ，把变量 <code class="docutils literal notranslate"><span class="pre">$(CFLAGS)</span></code>
重定义成 <code class="docutils literal notranslate"><span class="pre">-g</span></code> ，那么，隐含规则中的命令全部会以 <code class="docutils literal notranslate"><span class="pre">gcc</span> <span class="pre">–c</span> <span class="pre">-g</span> <span class="pre">$(CPPFLAGS)</span></code> 的样子来执行了。</p>
<p>我们可以把隐含规则中使用的变量分成两种：一种是命令相关的，如 <code class="docutils literal notranslate"><span class="pre">CC</span></code> ；一种是参数相的关，如
<code class="docutils literal notranslate"><span class="pre">CFLAGS</span></code> 。下面是所有隐含规则中会用到的变量：</p>
<section id="id5">
<h3>关于命令的变量。<a class="headerlink" href="#id5" title="永久链接至标题"></a></h3>
<ul class="simple">
<li><p><code class="docutils literal notranslate"><span class="pre">AR</span></code> : 函数库打包程序。默认命令是 <code class="docutils literal notranslate"><span class="pre">ar</span></code></p></li>
<li><p><code class="docutils literal notranslate"><span class="pre">AS</span></code> : 汇编语言编译程序。默认命令是 <code class="docutils literal notranslate"><span class="pre">as</span></code></p></li>
<li><p><code class="docutils literal notranslate"><span class="pre">CC</span></code> : C语言编译程序。默认命令是 <code class="docutils literal notranslate"><span class="pre">cc</span></code></p></li>
<li><p><code class="docutils literal notranslate"><span class="pre">CXX</span></code> : C++语言编译程序。默认命令是 <code class="docutils literal notranslate"><span class="pre">g++</span></code></p></li>
<li><p><code class="docutils literal notranslate"><span class="pre">CO</span></code> : 从 RCS文件中扩展文件程序。默认命令是 <code class="docutils literal notranslate"><span class="pre">co</span></code></p></li>
<li><p><code class="docutils literal notranslate"><span class="pre">CPP</span></code> : C程序的预处理器（输出是标准输出设备）。默认命令是 <code class="docutils literal notranslate"><span class="pre">$(CC)</span> <span class="pre">–E</span></code></p></li>
<li><p><code class="docutils literal notranslate"><span class="pre">FC</span></code> : Fortran 和 Ratfor 的编译器和预处理程序。默认命令是 <code class="docutils literal notranslate"><span class="pre">f77</span></code></p></li>
<li><p><code class="docutils literal notranslate"><span class="pre">GET</span></code> : 从SCCS文件中扩展文件的程序。默认命令是 <code class="docutils literal notranslate"><span class="pre">get</span></code></p></li>
<li><p><code class="docutils literal notranslate"><span class="pre">LEX</span></code> : Lex方法分析器程序（针对于C或Ratfor）。默认命令是 <code class="docutils literal notranslate"><span class="pre">lex</span></code></p></li>
<li><p><code class="docutils literal notranslate"><span class="pre">PC</span></code> : Pascal语言编译程序。默认命令是 <code class="docutils literal notranslate"><span class="pre">pc</span></code></p></li>
<li><p><code class="docutils literal notranslate"><span class="pre">YACC</span></code> : Yacc文法分析器（针对于C程序）。默认命令是 <code class="docutils literal notranslate"><span class="pre">yacc</span></code></p></li>
<li><p><code class="docutils literal notranslate"><span class="pre">YACCR</span></code> : Yacc文法分析器（针对于Ratfor程序）。默认命令是 <code class="docutils literal notranslate"><span class="pre">yacc</span> <span class="pre">–r</span></code></p></li>
<li><p><code class="docutils literal notranslate"><span class="pre">MAKEINFO</span></code> : 转换Texinfo源文件（.texi）到Info文件程序。默认命令是 <code class="docutils literal notranslate"><span class="pre">makeinfo</span></code></p></li>
<li><p><code class="docutils literal notranslate"><span class="pre">TEX</span></code> : 从TeX源文件创建TeX DVI文件的程序。默认命令是 <code class="docutils literal notranslate"><span class="pre">tex</span></code></p></li>
<li><p><code class="docutils literal notranslate"><span class="pre">TEXI2DVI</span></code> : 从Texinfo源文件创建军TeX DVI 文件的程序。默认命令是 <code class="docutils literal notranslate"><span class="pre">texi2dvi</span></code></p></li>
<li><p><code class="docutils literal notranslate"><span class="pre">WEAVE</span></code> : 转换Web到TeX的程序。默认命令是 <code class="docutils literal notranslate"><span class="pre">weave</span></code></p></li>
<li><p><code class="docutils literal notranslate"><span class="pre">CWEAVE</span></code> : 转换C Web 到 TeX的程序。默认命令是 <code class="docutils literal notranslate"><span class="pre">cweave</span></code></p></li>
<li><p><code class="docutils literal notranslate"><span class="pre">TANGLE</span></code> : 转换Web到Pascal语言的程序。默认命令是 <code class="docutils literal notranslate"><span class="pre">tangle</span></code></p></li>
<li><p><code class="docutils literal notranslate"><span class="pre">CTANGLE</span></code> : 转换C Web 到 C。默认命令是 <code class="docutils literal notranslate"><span class="pre">ctangle</span></code></p></li>
<li><p><code class="docutils literal notranslate"><span class="pre">RM</span></code> : 删除文件命令。默认命令是 <code class="docutils literal notranslate"><span class="pre">rm</span> <span class="pre">–f</span></code></p></li>
</ul>
</section>
<section id="id6">
<h3>关于命令参数的变量<a class="headerlink" href="#id6" title="永久链接至标题"></a></h3>
<p>下面的这些变量都是相关上面的命令的参数。如果没有指明其默认值，那么其默认值都是空。</p>
<ul class="simple">
<li><p><code class="docutils literal notranslate"><span class="pre">ARFLAGS</span></code> : 函数库打包程序AR命令的参数。默认值是 <code class="docutils literal notranslate"><span class="pre">rv</span></code></p></li>
<li><p><code class="docutils literal notranslate"><span class="pre">ASFLAGS</span></code> : 汇编语言编译器参数。（当明显地调用 <code class="docutils literal notranslate"><span class="pre">.s</span></code> 或 <code class="docutils literal notranslate"><span class="pre">.S</span></code> 文件时）</p></li>
<li><p><code class="docutils literal notranslate"><span class="pre">CFLAGS</span></code> : C语言编译器参数。</p></li>
<li><p><code class="docutils literal notranslate"><span class="pre">CXXFLAGS</span></code> : C++语言编译器参数。</p></li>
<li><p><code class="docutils literal notranslate"><span class="pre">COFLAGS</span></code> : RCS命令参数。</p></li>
<li><p><code class="docutils literal notranslate"><span class="pre">CPPFLAGS</span></code> : C预处理器参数。（ C 和 Fortran 编译器也会用到）。</p></li>
<li><p><code class="docutils literal notranslate"><span class="pre">FFLAGS</span></code> : Fortran语言编译器参数。</p></li>
<li><p><code class="docutils literal notranslate"><span class="pre">GFLAGS</span></code> : SCCS “get”程序参数。</p></li>
<li><p><code class="docutils literal notranslate"><span class="pre">LDFLAGS</span></code> : 链接器参数。（如： <code class="docutils literal notranslate"><span class="pre">ld</span></code> ）</p></li>
<li><p><code class="docutils literal notranslate"><span class="pre">LFLAGS</span></code> : Lex文法分析器参数。</p></li>
<li><p><code class="docutils literal notranslate"><span class="pre">PFLAGS</span></code> : Pascal语言编译器参数。</p></li>
<li><p><code class="docutils literal notranslate"><span class="pre">RFLAGS</span></code> : Ratfor 程序的Fortran 编译器参数。</p></li>
<li><p><code class="docutils literal notranslate"><span class="pre">YFLAGS</span></code> : Yacc文法分析器参数。</p></li>
</ul>
</section>
</section>
<section id="id7">
<h2>隐含规则链<a class="headerlink" href="#id7" title="永久链接至标题"></a></h2>
<p>有些时候，一个目标可能被一系列的隐含规则所作用。例如，一个 <code class="docutils literal notranslate"><span class="pre">.o</span></code> 的文件生成，可能会是先被
Yacc的[.y]文件先成 <code class="docutils literal notranslate"><span class="pre">.c</span></code> ，然后再被C的编译器生成。我们把这一系列的隐含规则叫做“隐含规则链”。</p>
<p>在上面的例子中，如果文件 <code class="docutils literal notranslate"><span class="pre">.c</span></code> 存在，那么就直接调用C的编译器的隐含规则，如果没有 <code class="docutils literal notranslate"><span class="pre">.c</span></code> 文件，但有一个 <code class="docutils literal notranslate"><span class="pre">.y</span></code> 文件，那么Yacc的隐含规则会被调用，生成 <code class="docutils literal notranslate"><span class="pre">.c</span></code> 文件，然后，再调用C编译的隐含规则最终由 <code class="docutils literal notranslate"><span class="pre">.c</span></code> 生成 <code class="docutils literal notranslate"><span class="pre">.o</span></code> 文件，达到目标。</p>
<p>我们把这种 <code class="docutils literal notranslate"><span class="pre">.c</span></code> 的文件（或是目标），叫做中间目标。不管怎么样，make会努力自动推导生成目标的一切方法，不管中间目标有多少，其都会执着地把所有的隐含规则和你书写的规则全部合起来分析，努力达到目标，所以，有些时候，可能会让你觉得奇怪，怎么我的目标会这样生成？怎么我的 makefile发疯了？</p>
<p>在默认情况下，对于中间目标，它和一般的目标有两个地方所不同：第一个不同是除非中间的目标不存在，才会引发中间规则。第二个不同的是，只要目标成功产生，那么，产生最终目标过程中，所产生的中间目标文件会被以 <code class="docutils literal notranslate"><span class="pre">rm</span> <span class="pre">-f</span></code> 删除。</p>
<p>通常，一个被makefile指定成目标或是依赖目标的文件不能被当作中介。然而，你可以明显地说明一个文件或是目标是中介目标，你可以使用伪目标 <code class="docutils literal notranslate"><span class="pre">.INTERMEDIATE</span></code> 来强制声明。（如： <code class="docutils literal notranslate"><span class="pre">.INTERMEDIATE</span> <span class="pre">:</span> <span class="pre">mid</span></code> ）</p>
<p>你也可以阻止make自动删除中间目标，要做到这一点，你可以使用伪目标 <code class="docutils literal notranslate"><span class="pre">.SECONDARY</span></code> 来强制声明（如： <code class="docutils literal notranslate"><span class="pre">.SECONDARY</span> <span class="pre">:</span> <span class="pre">sec</span></code> ）。你还可以把你的目标，以模式的方式来指定（如： <code class="docutils literal notranslate"><span class="pre">%.o</span></code> ）成伪目标 <code class="docutils literal notranslate"><span class="pre">.PRECIOUS</span></code> 的依赖目标，以保存被隐含规则所生成的中间文件。</p>
<p>在“隐含规则链”中，禁止同一个目标出现两次或两次以上，这样一来，就可防止在make自动推导时出现无限递归的情况。</p>
<p>Make会优化一些特殊的隐含规则，而不生成中间文件。如，从文件 <code class="docutils literal notranslate"><span class="pre">foo.c</span></code> 生成目标程序 <code class="docutils literal notranslate"><span class="pre">foo</span></code> ，按道理，make会编译生成中间文件 <code class="docutils literal notranslate"><span class="pre">foo.o</span></code> ，然后链接成 <code class="docutils literal notranslate"><span class="pre">foo</span></code> ，但在实际情况下，这一动作可以被一条 <code class="docutils literal notranslate"><span class="pre">cc</span></code> 的命令完成（ <code class="docutils literal notranslate"><span class="pre">cc</span> <span class="pre">–o</span> <span class="pre">foo</span> <span class="pre">foo.c</span></code> ），于是优化过的规则就不会生成中间文件。</p>
</section>
<section id="id8">
<h2>定义模式规则<a class="headerlink" href="#id8" title="永久链接至标题"></a></h2>
<p>你可以使用模式规则来定义一个隐含规则。一个模式规则就好像一个一般的规则，只是在规则中，目标的定义需要有 <code class="docutils literal notranslate"><span class="pre">%</span></code> 字符。 <code class="docutils literal notranslate"><span class="pre">%</span></code> 的意思是表示一个或多个任意字符。在依赖目标中同样可以使用 <code class="docutils literal notranslate"><span class="pre">%</span></code> ，只是依赖目标中的 <code class="docutils literal notranslate"><span class="pre">%</span></code> 的取值，取决于其目标。</p>
<p>有一点需要注意的是， <code class="docutils literal notranslate"><span class="pre">%</span></code> 的展开发生在变量和函数的展开之后，变量和函数的展开发生在make载入
Makefile时，而模式规则中的 <code class="docutils literal notranslate"><span class="pre">%</span></code> 则发生在运行时。</p>
<section id="id9">
<h3>模式规则介绍<a class="headerlink" href="#id9" title="永久链接至标题"></a></h3>
<p>模式规则中，至少在规则的目标定义中要包含 <code class="docutils literal notranslate"><span class="pre">%</span></code> ，否则，就是一般的规则。目标中的 <code class="docutils literal notranslate"><span class="pre">%</span></code> 定义表示对文件名的匹配， <code class="docutils literal notranslate"><span class="pre">%</span></code> 表示长度任意的非空字符串。例如： <code class="docutils literal notranslate"><span class="pre">%.c</span></code> 表示以 <code class="docutils literal notranslate"><span class="pre">.c</span></code> 结尾的文件名（文件名的长度至少为3），而 <code class="docutils literal notranslate"><span class="pre">s.%.c</span></code> 则表示以 <code class="docutils literal notranslate"><span class="pre">s.</span></code> 开头， <code class="docutils literal notranslate"><span class="pre">.c</span></code> 结尾的文件名（文件名的长度至少为5）。</p>
<p>如果 <code class="docutils literal notranslate"><span class="pre">%</span></code> 定义在目标中，那么，目标中的 <code class="docutils literal notranslate"><span class="pre">%</span></code> 的值决定了依赖目标中的 <code class="docutils literal notranslate"><span class="pre">%</span></code> 的值，也就是说，目标中的模式的 <code class="docutils literal notranslate"><span class="pre">%</span></code> 决定了依赖目标中 <code class="docutils literal notranslate"><span class="pre">%</span></code> 的样子。例如有一个模式规则如下：</p>
<div class="highlight-makefile notranslate"><div class="highlight"><pre><span></span><span class="nf">%.o </span><span class="o">:</span> %.<span class="n">c</span> ; &lt;<span class="n">command</span> ......&gt;;
</pre></div>
</div>
<p>其含义是，指出了怎么从所有的 <code class="docutils literal notranslate"><span class="pre">.c</span></code> 文件生成相应的 <code class="docutils literal notranslate"><span class="pre">.o</span></code> 文件的规则。如果要生成的目标是
<code class="docutils literal notranslate"><span class="pre">a.o</span> <span class="pre">b.o</span></code> ，那么 <code class="docutils literal notranslate"><span class="pre">%c</span></code> 就是 <code class="docutils literal notranslate"><span class="pre">a.c</span> <span class="pre">b.c</span></code> 。</p>
<p>一旦依赖目标中的 <code class="docutils literal notranslate"><span class="pre">%</span></code> 模式被确定，那么，make会被要求去匹配当前目录下所有的文件名，一旦找到，make就会规则下的命令，所以，在模式规则中，目标可能会是多个的，如果有模式匹配出多个目标，make就会产生所有的模式目标，此时，make关心的是依赖的文件名和生成目标的命令这两件事。</p>
</section>
<section id="id10">
<h3>模式规则示例<a class="headerlink" href="#id10" title="永久链接至标题"></a></h3>
<p>下面这个例子表示了,把所有的 <code class="docutils literal notranslate"><span class="pre">.c</span></code> 文件都编译成 <code class="docutils literal notranslate"><span class="pre">.o</span></code> 文件.</p>
<div class="highlight-makefile notranslate"><div class="highlight"><pre><span></span><span class="nf">%.o </span><span class="o">:</span> %.<span class="n">c</span>
<span class="k">$(</span>CC<span class="k">)</span> -c <span class="k">$(</span>CFLAGS<span class="k">)</span> <span class="k">$(</span>CPPFLAGS<span class="k">)</span> $&lt; -o <span class="nv">$@</span>
</pre></div>
</div>
<p>其中， <code class="docutils literal notranslate"><span class="pre">$&#64;</span></code> 表示所有的目标的挨个值， <code class="docutils literal notranslate"><span class="pre">$&lt;</span></code> 表示了所有依赖目标的挨个值。这些奇怪的变量我们叫“自动化变量”，后面会详细讲述。</p>
<p>下面的这个例子中有两个目标是模式的：</p>
<div class="highlight-makefile notranslate"><div class="highlight"><pre><span></span><span class="nf">%.tab.c %.tab.h</span><span class="o">:</span> %.<span class="n">y</span>
bison -d $&lt;
</pre></div>
</div>
<p>这条规则告诉make把所有的 <code class="docutils literal notranslate"><span class="pre">.y</span></code> 文件都以 <code class="docutils literal notranslate"><span class="pre">bison</span> <span class="pre">-d</span> <span class="pre">&lt;n&gt;.y</span></code> 执行，然后生成 <code class="docutils literal notranslate"><span class="pre">&lt;n&gt;.tab.c</span></code>
和 <code class="docutils literal notranslate"><span class="pre">&lt;n&gt;.tab.h</span></code> 文件。（其中， <code class="docutils literal notranslate"><span class="pre">&lt;n&gt;</span></code> 表示一个任意字符串）。如果我们的执行程序 <code class="docutils literal notranslate"><span class="pre">foo</span></code>
依赖于文件 <code class="docutils literal notranslate"><span class="pre">parse.tab.o</span></code> 和 <code class="docutils literal notranslate"><span class="pre">scan.o</span></code> ，并且文件 <code class="docutils literal notranslate"><span class="pre">scan.o</span></code> 依赖于文件 <code class="docutils literal notranslate"><span class="pre">parse.tab.h</span></code> ，如果 <code class="docutils literal notranslate"><span class="pre">parse.y</span></code> 文件被更新了，那么根据上述的规则， <code class="docutils literal notranslate"><span class="pre">bison</span> <span class="pre">-d</span> <span class="pre">parse.y</span></code> 就会被执行一次，于是， <code class="docutils literal notranslate"><span class="pre">parse.tab.o</span></code> 和 <code class="docutils literal notranslate"><span class="pre">scan.o</span></code> 的依赖文件就齐了。（假设， <code class="docutils literal notranslate"><span class="pre">parse.tab.o</span></code> 由
<code class="docutils literal notranslate"><span class="pre">parse.tab.c</span></code> 生成，和 <code class="docutils literal notranslate"><span class="pre">scan.o</span></code> 由 <code class="docutils literal notranslate"><span class="pre">scan.c</span></code> 生成，而 <code class="docutils literal notranslate"><span class="pre">foo</span></code> 由 <code class="docutils literal notranslate"><span class="pre">parse.tab.o</span></code>
和 <code class="docutils literal notranslate"><span class="pre">scan.o</span></code> 链接生成，而且 <code class="docutils literal notranslate"><span class="pre">foo</span></code> 和其 <code class="docutils literal notranslate"><span class="pre">.o</span></code> 文件的依赖关系也写好，那么，所有的目标都会得到满足）</p>
</section>
<section id="id11">
<h3>自动化变量<a class="headerlink" href="#id11" title="永久链接至标题"></a></h3>
<p>在上述的模式规则中，目标和依赖文件都是一系例的文件，那么我们如何书写一个命令来完成从不同的依赖文件生成相应的目标？因为在每一次的对模式规则的解析时，都会是不同的目标和依赖文件。</p>
<p>自动化变量就是完成这个功能的。在前面，我们已经对自动化变量有所提涉，相信你看到这里已对它有一个感性认识了。所谓自动化变量，就是这种变量会把模式中所定义的一系列的文件自动地挨个取出，直至所有的符合模式的文件都取完了。这种自动化变量只应出现在规则的命令中。</p>
<p>下面是所有的自动化变量及其说明：</p>
<ul class="simple">
<li><p><code class="docutils literal notranslate"><span class="pre">$&#64;</span></code> : 表示规则中的目标文件集。在模式规则中，如果有多个目标，那么， <code class="docutils literal notranslate"><span class="pre">$&#64;</span></code> 就是匹配于目标中模式定义的集合。</p></li>
<li><p><code class="docutils literal notranslate"><span class="pre">$%</span></code> : 仅当目标是函数库文件中，表示规则中的目标成员名。例如，如果一个目标是 <code class="docutils literal notranslate"><span class="pre">foo.a(bar.o)</span></code> ，那么， <code class="docutils literal notranslate"><span class="pre">$%</span></code> 就是 <code class="docutils literal notranslate"><span class="pre">bar.o</span></code> ， <code class="docutils literal notranslate"><span class="pre">$&#64;</span></code> 就是 <code class="docutils literal notranslate"><span class="pre">foo.a</span></code> 。如果目标不是函数库文件（Unix下是 <code class="docutils literal notranslate"><span class="pre">.a</span></code> ，Windows下是 <code class="docutils literal notranslate"><span class="pre">.lib</span></code> ），那么，其值为空。</p></li>
<li><p><code class="docutils literal notranslate"><span class="pre">$&lt;</span></code> : 依赖目标中的第一个目标名字。如果依赖目标是以模式（即 <code class="docutils literal notranslate"><span class="pre">%</span></code> ）定义的，那么 <code class="docutils literal notranslate"><span class="pre">$&lt;</span></code>
将是符合模式的一系列的文件集。注意，其是一个一个取出来的。</p></li>
<li><p><code class="docutils literal notranslate"><span class="pre">$?</span></code> : 所有比目标新的依赖目标的集合。以空格分隔。</p></li>
<li><p><code class="docutils literal notranslate"><span class="pre">$^</span></code> : 所有的依赖目标的集合。以空格分隔。如果在依赖目标中有多个重复的，那么这个变量会去除重复的依赖目标，只保留一份。</p></li>
<li><p><code class="docutils literal notranslate"><span class="pre">$+</span></code> : 这个变量很像 <code class="docutils literal notranslate"><span class="pre">$^</span></code> ，也是所有依赖目标的集合。只是它不去除重复的依赖目标。</p></li>
<li><p><code class="docutils literal notranslate"><span class="pre">$*</span></code> : 这个变量表示目标模式中 <code class="docutils literal notranslate"><span class="pre">%</span></code> 及其之前的部分。如果目标是 <code class="docutils literal notranslate"><span class="pre">dir/a.foo.b</span></code> ，并且目标的模式是 <code class="docutils literal notranslate"><span class="pre">a.%.b</span></code> ，那么， <code class="docutils literal notranslate"><span class="pre">$*</span></code> 的值就是 <code class="docutils literal notranslate"><span class="pre">dir/foo</span></code> 。这个变量对于构造有关联的文件名是比较有效。如果目标中没有模式的定义，那么 <code class="docutils literal notranslate"><span class="pre">$*</span></code> 也就不能被推导出，但是，如果目标文件的后缀是make所识别的，那么 <code class="docutils literal notranslate"><span class="pre">$*</span></code> 就是除了后缀的那一部分。例如：如果目标是 <code class="docutils literal notranslate"><span class="pre">foo.c</span></code> ，因为
<code class="docutils literal notranslate"><span class="pre">.c</span></code> 是make所能识别的后缀名，所以， <code class="docutils literal notranslate"><span class="pre">$*</span></code> 的值就是 <code class="docutils literal notranslate"><span class="pre">foo</span></code> 。这个特性是GNU make的，很有可能不兼容于其它版本的make，所以，你应该尽量避免使用 <code class="docutils literal notranslate"><span class="pre">$*</span></code> ，除非是在隐含规则或是静态模式中。如果目标中的后缀是make所不能识别的，那么 <code class="docutils literal notranslate"><span class="pre">$*</span></code> 就是空值。</p></li>
</ul>
<p>当你希望只对更新过的依赖文件进行操作时， <code class="docutils literal notranslate"><span class="pre">$?</span></code> 在显式规则中很有用，例如，假设有一个函数库文件叫 <code class="docutils literal notranslate"><span class="pre">lib</span></code> ，其由其它几个object文件更新。那么把object文件打包的比较有效率的Makefile规则是：</p>
<div class="highlight-makefile notranslate"><div class="highlight"><pre><span></span><span class="nf">lib </span><span class="o">:</span> <span class="n">foo</span>.<span class="n">o</span> <span class="n">bar</span>.<span class="n">o</span> <span class="n">lose</span>.<span class="n">o</span> <span class="n">win</span>.<span class="n">o</span>
ar r lib <span class="nv">$?</span>
</pre></div>
</div>
<p>在上述所列出来的自动量变量中。四个变量（ <code class="docutils literal notranslate"><span class="pre">$&#64;</span></code> 、 <code class="docutils literal notranslate"><span class="pre">$&lt;</span></code> 、 <code class="docutils literal notranslate"><span class="pre">$%</span></code> 、 <code class="docutils literal notranslate"><span class="pre">$*</span></code> ）在扩展时只会有一个文件，而另三个的值是一个文件列表。这七个自动化变量还可以取得文件的目录名或是在当前目录下的符合模式的文件名，只需要搭配上 <code class="docutils literal notranslate"><span class="pre">D</span></code> 或 <code class="docutils literal notranslate"><span class="pre">F</span></code> 字样。这是GNU make中老版本的特性，在新版本中，我们使用函数 <code class="docutils literal notranslate"><span class="pre">dir</span></code> 或 <code class="docutils literal notranslate"><span class="pre">notdir</span></code> 就可以做到了。 <code class="docutils literal notranslate"><span class="pre">D</span></code> 的含义就是Directory，就是目录， <code class="docutils literal notranslate"><span class="pre">F</span></code> 的含义就是File，就是文件。</p>
<p>下面是对于上面的七个变量分别加上 <code class="docutils literal notranslate"><span class="pre">D</span></code> 或是 <code class="docutils literal notranslate"><span class="pre">F</span></code> 的含义：</p>
<dl class="simple">
<dt><code class="docutils literal notranslate"><span class="pre">$(&#64;D)</span></code></dt><dd><p>表示 <code class="docutils literal notranslate"><span class="pre">$&#64;</span></code> 的目录部分（不以斜杠作为结尾），如果 <code class="docutils literal notranslate"><span class="pre">$&#64;</span></code> 值是 <code class="docutils literal notranslate"><span class="pre">dir/foo.o</span></code> ，那么
<code class="docutils literal notranslate"><span class="pre">$(&#64;D)</span></code> 就是 <code class="docutils literal notranslate"><span class="pre">dir</span></code> ，而如果 <code class="docutils literal notranslate"><span class="pre">$&#64;</span></code> 中没有包含斜杠的话，其值就是 <code class="docutils literal notranslate"><span class="pre">.</span></code> （当前目录）。</p>
</dd>
<dt><code class="docutils literal notranslate"><span class="pre">$(&#64;F)</span></code></dt><dd><p>表示 <code class="docutils literal notranslate"><span class="pre">$&#64;</span></code> 的文件部分，如果 <code class="docutils literal notranslate"><span class="pre">$&#64;</span></code> 值是 <code class="docutils literal notranslate"><span class="pre">dir/foo.o</span></code> ，那么 <code class="docutils literal notranslate"><span class="pre">$(&#64;F)</span></code> 就是 <code class="docutils literal notranslate"><span class="pre">foo.o</span></code> ，
<code class="docutils literal notranslate"><span class="pre">$(&#64;F)</span></code> 相当于函数 <code class="docutils literal notranslate"><span class="pre">$(notdir</span> <span class="pre">$&#64;)</span></code> 。</p>
</dd>
<dt><code class="docutils literal notranslate"><span class="pre">$(*D)</span></code>, <code class="docutils literal notranslate"><span class="pre">$(*F)</span></code></dt><dd><p>和上面所述的同理，也是取文件的目录部分和文件部分。对于上面的那个例子， <code class="docutils literal notranslate"><span class="pre">$(*D)</span></code> 返回 <code class="docutils literal notranslate"><span class="pre">dir</span></code> ，而 <code class="docutils literal notranslate"><span class="pre">$(*F)</span></code> 返回 <code class="docutils literal notranslate"><span class="pre">foo</span></code></p>
</dd>
<dt><code class="docutils literal notranslate"><span class="pre">$(%D)</span></code>, <code class="docutils literal notranslate"><span class="pre">$(%F)</span></code></dt><dd><p>分别表示了函数包文件成员的目录部分和文件部分。这对于形同 <code class="docutils literal notranslate"><span class="pre">archive(member)</span></code> 形式的目标中的
<code class="docutils literal notranslate"><span class="pre">member</span></code> 中包含了不同的目录很有用。</p>
</dd>
<dt><code class="docutils literal notranslate"><span class="pre">$(&lt;D)</span></code>, <code class="docutils literal notranslate"><span class="pre">$(&lt;F)</span></code></dt><dd><p>分别表示依赖文件的目录部分和文件部分。</p>
</dd>
<dt><code class="docutils literal notranslate"><span class="pre">$(^D)</span></code>, <code class="docutils literal notranslate"><span class="pre">$(^F)</span></code></dt><dd><p>分别表示所有依赖文件的目录部分和文件部分。（无相同的）</p>
</dd>
<dt><code class="docutils literal notranslate"><span class="pre">$(+D)</span></code>, <code class="docutils literal notranslate"><span class="pre">$(+F)</span></code></dt><dd><p>分别表示所有依赖文件的目录部分和文件部分。（可以有相同的）</p>
</dd>
<dt><code class="docutils literal notranslate"><span class="pre">$(?D)</span></code>, <code class="docutils literal notranslate"><span class="pre">$(?F)</span></code></dt><dd><p>分别表示被更新的依赖文件的目录部分和文件部分。</p>
</dd>
</dl>
<p>最后想提醒一下的是，对于 <code class="docutils literal notranslate"><span class="pre">$&lt;</span></code> ，为了避免产生不必要的麻烦，我们最好给 <code class="docutils literal notranslate"><span class="pre">$</span></code> 后面的那个特定字符都加上圆括号，比如， <code class="docutils literal notranslate"><span class="pre">$(&lt;)</span></code> 就要比 <code class="docutils literal notranslate"><span class="pre">$&lt;</span></code> 要好一些。</p>
<p>还得要注意的是，这些变量只使用在规则的命令中，而且一般都是“显式规则”和“静态模式规则”（参见前面“书写规则”一章）。其在隐含规则中并没有意义。</p>
</section>
<section id="id12">
<h3>模式的匹配<a class="headerlink" href="#id12" title="永久链接至标题"></a></h3>
<p>一般来说，一个目标的模式有一个有前缀或是后缀的 <code class="docutils literal notranslate"><span class="pre">%</span></code> ，或是没有前后缀，直接就是一个 <code class="docutils literal notranslate"><span class="pre">%</span></code> 。因为 <code class="docutils literal notranslate"><span class="pre">%</span></code> 代表一个或多个字符，所以在定义好了的模式中，我们把 <code class="docutils literal notranslate"><span class="pre">%</span></code> 所匹配的内容叫做“茎”，例如
<code class="docutils literal notranslate"><span class="pre">%.c</span></code> 所匹配的文件“test.c”中“test”就是“茎”。因为在目标和依赖目标中同时有 <code class="docutils literal notranslate"><span class="pre">%</span></code> 时，依赖目标的“茎”会传给目标，当做目标中的“茎”。</p>
<p>当一个模式匹配包含有斜杠（实际也不经常包含）的文件时，那么在进行模式匹配时，目录部分会首先被移开，然后进行匹配，成功后，再把目录加回去。在进行“茎”的传递时，我们需要知道这个步骤。例如有一个模式
<code class="docutils literal notranslate"><span class="pre">e%t</span></code> ，文件 <code class="docutils literal notranslate"><span class="pre">src/eat</span></code> 匹配于该模式，于是 <code class="docutils literal notranslate"><span class="pre">src/a</span></code> 就是其“茎”，如果这个模式定义在依赖目标中，而被依赖于这个模式的目标中又有个模式 <code class="docutils literal notranslate"><span class="pre">c%r</span></code> ，那么，目标就是 <code class="docutils literal notranslate"><span class="pre">src/car</span></code> 。（“茎”被传递）</p>
</section>
<section id="id13">
<h3>重载内建隐含规则<a class="headerlink" href="#id13" title="永久链接至标题"></a></h3>
<p>你可以重载内建的隐含规则（或是定义一个全新的），例如你可以重新构造和内建隐含规则不同的命令，如：</p>
<div class="highlight-makefile notranslate"><div class="highlight"><pre><span></span><span class="nf">%.o </span><span class="o">:</span> %.<span class="n">c</span>
<span class="k">$(</span>CC<span class="k">)</span> -c <span class="k">$(</span>CPPFLAGS<span class="k">)</span> <span class="k">$(</span>CFLAGS<span class="k">)</span> -D<span class="k">$(</span>date<span class="k">)</span>
</pre></div>
</div>
<p>你可以取消内建的隐含规则，只要不在后面写命令就行。如：</p>
<div class="highlight-makefile notranslate"><div class="highlight"><pre><span></span><span class="nf">%.o </span><span class="o">:</span> %.<span class="n">s</span>
</pre></div>
</div>
<p>同样，你也可以重新定义一个全新的隐含规则，其在隐含规则中的位置取决于你在哪里写下这个规则。朝前的位置就靠前。</p>
</section>
</section>
<section id="id14">
<h2>老式风格的“后缀规则”<a class="headerlink" href="#id14" title="永久链接至标题"></a></h2>
<p>后缀规则是一个比较老式的定义隐含规则的方法。后缀规则会被模式规则逐步地取代。因为模式规则更强更清晰。为了和老版本的Makefile兼容，GNU make同样兼容于这些东西。后缀规则有两种方式：“双后缀”和“单后缀”。</p>
<p>双后缀规则定义了一对后缀：目标文件的后缀和依赖目标（源文件）的后缀。如 <code class="docutils literal notranslate"><span class="pre">.c.o</span></code> 相当于 <code class="docutils literal notranslate"><span class="pre">%o</span> <span class="pre">:</span> <span class="pre">%c</span></code> 。单后缀规则只定义一个后缀，也就是源文件的后缀。如 <code class="docutils literal notranslate"><span class="pre">.c</span></code> 相当于 <code class="docutils literal notranslate"><span class="pre">%</span> <span class="pre">:</span> <span class="pre">%.c</span></code> 。</p>
<p>后缀规则中所定义的后缀应该是make所认识的，如果一个后缀是make所认识的，那么这个规则就是单后缀规则，而如果两个连在一起的后缀都被make所认识，那就是双后缀规则。例如： <code class="docutils literal notranslate"><span class="pre">.c</span></code> 和 <code class="docutils literal notranslate"><span class="pre">.o</span></code> 都是make所知道。因而，如果你定义了一个规则是 <code class="docutils literal notranslate"><span class="pre">.c.o</span></code> 那么其就是双后缀规则，意义就是 <code class="docutils literal notranslate"><span class="pre">.c</span></code> 是源文件的后缀， <code class="docutils literal notranslate"><span class="pre">.o</span></code>
是目标文件的后缀。如下示例：</p>
<div class="highlight-makefile notranslate"><div class="highlight"><pre><span></span><span class="nf">.c.o</span><span class="o">:</span>
<span class="k">$(</span>CC<span class="k">)</span> -c <span class="k">$(</span>CFLAGS<span class="k">)</span> <span class="k">$(</span>CPPFLAGS<span class="k">)</span> -o <span class="nv">$@</span> $&lt;
</pre></div>
</div>
<p>后缀规则不允许任何的依赖文件，如果有依赖文件的话，那就不是后缀规则，那些后缀统统被认为是文件名，如：</p>
<div class="highlight-makefile notranslate"><div class="highlight"><pre><span></span><span class="nf">.c.o</span><span class="o">:</span> <span class="n">foo</span>.<span class="n">h</span>
<span class="k">$(</span>CC<span class="k">)</span> -c <span class="k">$(</span>CFLAGS<span class="k">)</span> <span class="k">$(</span>CPPFLAGS<span class="k">)</span> -o <span class="nv">$@</span> $&lt;
</pre></div>
</div>
<p>这个例子，就是说，文件 <code class="docutils literal notranslate"><span class="pre">.c.o</span></code> 依赖于文件 <code class="docutils literal notranslate"><span class="pre">foo.h</span></code> ，而不是我们想要的这样：</p>
<div class="highlight-makefile notranslate"><div class="highlight"><pre><span></span><span class="nf">%.o</span><span class="o">:</span> %.<span class="n">c</span> <span class="n">foo</span>.<span class="n">h</span>
<span class="k">$(</span>CC<span class="k">)</span> -c <span class="k">$(</span>CFLAGS<span class="k">)</span> <span class="k">$(</span>CPPFLAGS<span class="k">)</span> -o <span class="nv">$@</span> $&lt;
</pre></div>
</div>
<p>后缀规则中，如果没有命令，那是毫无意义的。因为他也不会移去内建的隐含规则。</p>
<p>而要让make知道一些特定的后缀，我们可以使用伪目标 <code class="docutils literal notranslate"><span class="pre">.SUFFIXES</span></code> 来定义或是删除，如：</p>
<div class="highlight-makefile notranslate"><div class="highlight"><pre><span></span><span class="nf">.SUFFIXES</span><span class="o">:</span> .<span class="n">hack</span> .<span class="n">win</span>
</pre></div>
</div>
<p>把后缀 <code class="docutils literal notranslate"><span class="pre">.hack</span></code> 和 <code class="docutils literal notranslate"><span class="pre">.win</span></code> 加入后缀列表中的末尾。</p>
<div class="highlight-makefile notranslate"><div class="highlight"><pre><span></span><span class="nf">.SUFFIXES</span><span class="o">:</span> <span class="c"># 删除默认的后缀</span>
<span class="nf">.SUFFIXES</span><span class="o">:</span> .<span class="n">c</span> .<span class="n">o</span> .<span class="n">h</span> <span class="c"># 定义自己的后缀</span>
</pre></div>
</div>
<p>先清除默认后缀，后定义自己的后缀列表。</p>
<p>make的参数 <code class="docutils literal notranslate"><span class="pre">-r</span></code> 或 <code class="docutils literal notranslate"><span class="pre">-no-builtin-rules</span></code> 也会使用得默认的后缀列表为空。而变量
<code class="docutils literal notranslate"><span class="pre">SUFFIXE</span></code> 被用来定义默认的后缀列表，你可以用 <code class="docutils literal notranslate"><span class="pre">.SUFFIXES</span></code> 来改变后缀列表，但请不要改变变量 <code class="docutils literal notranslate"><span class="pre">SUFFIXE</span></code> 的值。</p>
</section>
<section id="id15">
<h2>隐含规则搜索算法<a class="headerlink" href="#id15" title="永久链接至标题"></a></h2>
<p>比如我们有一个目标叫 T。下面是搜索目标T的规则的算法。请注意，在下面，我们没有提到后缀规则，原因是，所有的后缀规则在Makefile被载入内存时，会被转换成模式规则。如果目标是 <code class="docutils literal notranslate"><span class="pre">archive(member)</span></code>
的函数库文件模式，那么这个算法会被运行两次，第一次是找目标T，如果没有找到的话，那么进入第二次，第二次会把 <code class="docutils literal notranslate"><span class="pre">member</span></code> 当作T来搜索。</p>
<ol class="arabic simple">
<li><p>把T的目录部分分离出来。叫D，而剩余部分叫N。（如：如果T是 <code class="docutils literal notranslate"><span class="pre">src/foo.o</span></code> ，那么，D就是
<code class="docutils literal notranslate"><span class="pre">src/</span></code> ，N就是 <code class="docutils literal notranslate"><span class="pre">foo.o</span></code> ）</p></li>
<li><p>创建所有匹配于T或是N的模式规则列表。</p></li>
<li><p>如果在模式规则列表中有匹配所有文件的模式，如 <code class="docutils literal notranslate"><span class="pre">%</span></code> ，那么从列表中移除其它的模式。</p></li>
<li><p>移除列表中没有命令的规则。</p></li>
<li><p>对于第一个在列表中的模式规则：</p>
<ol class="arabic simple">
<li><p>推导其“茎”S，S应该是T或是N匹配于模式中 <code class="docutils literal notranslate"><span class="pre">%</span></code> 非空的部分。</p></li>
<li><p>计算依赖文件。把依赖文件中的 <code class="docutils literal notranslate"><span class="pre">%</span></code> 都替换成“茎”S。如果目标模式中没有包含斜框字符，而把D加在第一个依赖文件的开头。</p></li>
<li><p>测试是否所有的依赖文件都存在或是理当存在。（如果有一个文件被定义成另外一个规则的目标文件，或者是一个显式规则的依赖文件，那么这个文件就叫“理当存在”）</p></li>
<li><p>如果所有的依赖文件存在或是理当存在，或是就没有依赖文件。那么这条规则将被采用，退出该算法。</p></li>
</ol>
</li>
<li><p>如果经过第5步，没有模式规则被找到，那么就做更进一步的搜索。对于存在于列表中的第一个模式规则：</p>
<ol class="arabic simple">
<li><p>如果规则是终止规则，那就忽略它，继续下一条模式规则。</p></li>
<li><p>计算依赖文件。（同第5步）</p></li>
<li><p>测试所有的依赖文件是否存在或是理当存在。</p></li>
<li><p>对于不存在的依赖文件，递归调用这个算法查找他是否可以被隐含规则找到。</p></li>
<li><p>如果所有的依赖文件存在或是理当存在，或是就根本没有依赖文件。那么这条规则被采用，退出该算法。</p></li>
<li><p>如果没有隐含规则可以使用，查看 <code class="docutils literal notranslate"><span class="pre">.DEFAULT</span></code> 规则，如果有，采用，把 <code class="docutils literal notranslate"><span class="pre">.DEFAULT</span></code> 的命令给T使用。</p></li>
</ol>
</li>
</ol>
<p>一旦规则被找到，就会执行其相当的命令，而此时，我们的自动化变量的值才会生成。</p>
</section>
</section>
</div>
</div>
<footer><div class="rst-footer-buttons" role="navigation" aria-label="Footer">
<a href="invoke.html" class="btn btn-neutral float-left" title="make 的运行" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
<a href="archives.html" class="btn btn-neutral float-right" title="使用make更新函数库文件" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
</div>
<hr/>
<div role="contentinfo">
<p>&#169; 版权所有 2014-2019, 作者：陈皓；排版：SeisMan.
<span class="lastupdated">最后更新于 2022年5月22日.
</span></p>
</div>
Built with <a href="https://www.sphinx-doc.org/">Sphinx</a> using a
<a href="https://github.com/readthedocs/sphinx_rtd_theme">theme</a>
provided by <a href="https://readthedocs.org">Read the Docs</a>.
</footer>
</div>
</div>
</section>
</div>
<script>
jQuery(function () {
SphinxRtdTheme.Navigation.enable(true);
});
</script>
</body>
</html>

250
index.html Normal file
View File

@ -0,0 +1,250 @@
<!DOCTYPE html>
<html class="writer-html5" lang="zh-CN" >
<head>
<meta charset="utf-8" /><meta name="generator" content="Docutils 0.17.1: http://docutils.sourceforge.net/" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<title>跟我一起写Makefile &mdash; 跟我一起写Makefile 1.0 文档</title>
<link rel="stylesheet" href="_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="_static/css/theme.css" type="text/css" />
<!--[if lt IE 9]>
<script src="_static/js/html5shiv.min.js"></script>
<![endif]-->
<script data-url_root="./" id="documentation_options" src="_static/documentation_options.js"></script>
<script src="_static/jquery.js"></script>
<script src="_static/underscore.js"></script>
<script src="_static/doctools.js"></script>
<script src="_static/translations.js"></script>
<script src="_static/js/theme.js"></script>
<link rel="index" title="索引" href="genindex.html" />
<link rel="search" title="搜索" href="search.html" />
<link rel="next" title="概述" href="overview.html" />
</head>
<body class="wy-body-for-nav">
<div class="wy-grid-for-nav">
<nav data-toggle="wy-nav-shift" class="wy-nav-side">
<div class="wy-side-scroll">
<div class="wy-side-nav-search" >
<a href="#" class="icon icon-home"> 跟我一起写Makefile
</a>
<div class="version">
1.0
</div>
<div role="search">
<form id="rtd-search-form" class="wy-form" action="search.html" method="get">
<input type="text" name="q" placeholder="Search docs" />
<input type="hidden" name="check_keywords" value="yes" />
<input type="hidden" name="area" value="default" />
</form>
</div>
</div><div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="Navigation menu">
<p class="caption" role="heading"><span class="caption-text">目录</span></p>
<ul>
<li class="toctree-l1"><a class="reference internal" href="overview.html">概述</a></li>
<li class="toctree-l1"><a class="reference internal" href="introduction.html">makefile介绍</a></li>
<li class="toctree-l1"><a class="reference internal" href="rules.html">书写规则</a></li>
<li class="toctree-l1"><a class="reference internal" href="recipes.html">书写命令</a></li>
<li class="toctree-l1"><a class="reference internal" href="variables.html">使用变量</a></li>
<li class="toctree-l1"><a class="reference internal" href="conditionals.html">使用条件判断</a></li>
<li class="toctree-l1"><a class="reference internal" href="functions.html">使用函数</a></li>
<li class="toctree-l1"><a class="reference internal" href="invoke.html">make 的运行</a></li>
<li class="toctree-l1"><a class="reference internal" href="implicit_rules.html">隐含规则</a></li>
<li class="toctree-l1"><a class="reference internal" href="archives.html">使用make更新函数库文件</a></li>
<li class="toctree-l1"><a class="reference internal" href="postscript.html">后序</a></li>
</ul>
</div>
</div>
</nav>
<section data-toggle="wy-nav-shift" class="wy-nav-content-wrap"><nav class="wy-nav-top" aria-label="Mobile navigation menu" >
<i data-toggle="wy-nav-top" class="fa fa-bars"></i>
<a href="#">跟我一起写Makefile</a>
</nav>
<div class="wy-nav-content">
<div class="rst-content">
<div role="navigation" aria-label="Page navigation">
<ul class="wy-breadcrumbs">
<li><a href="#" class="icon icon-home"></a> &raquo;</li>
<li>跟我一起写Makefile</li>
<li class="wy-breadcrumbs-aside">
<a href="_sources/index.rst.txt" rel="nofollow"> View page source</a>
</li>
</ul>
<hr/>
</div>
<div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
<div itemprop="articleBody">
<section id="makefile">
<h1>跟我一起写Makefile<a class="headerlink" href="#makefile" title="永久链接至标题"></a></h1>
<p><strong>本文中可能存在很多 typo 和小错误，欢迎 PR。</strong></p>
<div class="toctree-wrapper compound">
<p class="caption" role="heading"><span class="caption-text">目录</span></p>
<ul>
<li class="toctree-l1"><a class="reference internal" href="overview.html">概述</a><ul>
<li class="toctree-l2"><a class="reference internal" href="overview.html#id2">关于程序的编译和链接</a></li>
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="introduction.html">makefile介绍</a><ul>
<li class="toctree-l2"><a class="reference internal" href="introduction.html#id1">makefile的规则</a></li>
<li class="toctree-l2"><a class="reference internal" href="introduction.html#id2">一个示例</a></li>
<li class="toctree-l2"><a class="reference internal" href="introduction.html#make">make是如何工作的</a></li>
<li class="toctree-l2"><a class="reference internal" href="introduction.html#id3">makefile中使用变量</a></li>
<li class="toctree-l2"><a class="reference internal" href="introduction.html#id4">让make自动推导</a></li>
<li class="toctree-l2"><a class="reference internal" href="introduction.html#makefiles">另类风格的makefiles</a></li>
<li class="toctree-l2"><a class="reference internal" href="introduction.html#id5">清空目标文件的规则</a></li>
<li class="toctree-l2"><a class="reference internal" href="introduction.html#id6">Makefile里有什么？</a></li>
<li class="toctree-l2"><a class="reference internal" href="introduction.html#id7">Makefile的文件名</a></li>
<li class="toctree-l2"><a class="reference internal" href="introduction.html#id8">引用其它的Makefile</a></li>
<li class="toctree-l2"><a class="reference internal" href="introduction.html#id9">环境变量MAKEFILES</a></li>
<li class="toctree-l2"><a class="reference internal" href="introduction.html#id10">make的工作方式</a></li>
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="rules.html">书写规则</a><ul>
<li class="toctree-l2"><a class="reference internal" href="rules.html#id2">规则举例</a></li>
<li class="toctree-l2"><a class="reference internal" href="rules.html#id3">规则的语法</a></li>
<li class="toctree-l2"><a class="reference internal" href="rules.html#id4">在规则中使用通配符</a></li>
<li class="toctree-l2"><a class="reference internal" href="rules.html#id5">文件搜寻</a></li>
<li class="toctree-l2"><a class="reference internal" href="rules.html#id6">伪目标</a></li>
<li class="toctree-l2"><a class="reference internal" href="rules.html#id7">多目标</a></li>
<li class="toctree-l2"><a class="reference internal" href="rules.html#id8">静态模式</a></li>
<li class="toctree-l2"><a class="reference internal" href="rules.html#id9">自动生成依赖性</a></li>
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="recipes.html">书写命令</a><ul>
<li class="toctree-l2"><a class="reference internal" href="recipes.html#id2">显示命令</a></li>
<li class="toctree-l2"><a class="reference internal" href="recipes.html#id3">命令执行</a></li>
<li class="toctree-l2"><a class="reference internal" href="recipes.html#id4">命令出错</a></li>
<li class="toctree-l2"><a class="reference internal" href="recipes.html#make">嵌套执行make</a></li>
<li class="toctree-l2"><a class="reference internal" href="recipes.html#id5">定义命令包</a></li>
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="variables.html">使用变量</a><ul>
<li class="toctree-l2"><a class="reference internal" href="variables.html#id2">变量的基础</a></li>
<li class="toctree-l2"><a class="reference internal" href="variables.html#id3">变量中的变量</a></li>
<li class="toctree-l2"><a class="reference internal" href="variables.html#id4">变量高级用法</a></li>
<li class="toctree-l2"><a class="reference internal" href="variables.html#id5">追加变量值</a></li>
<li class="toctree-l2"><a class="reference internal" href="variables.html#override">override 指示符</a></li>
<li class="toctree-l2"><a class="reference internal" href="variables.html#id6">多行变量</a></li>
<li class="toctree-l2"><a class="reference internal" href="variables.html#id7">环境变量</a></li>
<li class="toctree-l2"><a class="reference internal" href="variables.html#id8">目标变量</a></li>
<li class="toctree-l2"><a class="reference internal" href="variables.html#id9">模式变量</a></li>
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="conditionals.html">使用条件判断</a><ul>
<li class="toctree-l2"><a class="reference internal" href="conditionals.html#id2">示例</a></li>
<li class="toctree-l2"><a class="reference internal" href="conditionals.html#id3">语法</a></li>
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="functions.html">使用函数</a><ul>
<li class="toctree-l2"><a class="reference internal" href="functions.html#id2">函数的调用语法</a></li>
<li class="toctree-l2"><a class="reference internal" href="functions.html#id3">字符串处理函数</a><ul>
<li class="toctree-l3"><a class="reference internal" href="functions.html#subst">subst</a></li>
<li class="toctree-l3"><a class="reference internal" href="functions.html#patsubst">patsubst</a></li>
<li class="toctree-l3"><a class="reference internal" href="functions.html#strip">strip</a></li>
<li class="toctree-l3"><a class="reference internal" href="functions.html#findstring">findstring</a></li>
<li class="toctree-l3"><a class="reference internal" href="functions.html#filter">filter</a></li>
<li class="toctree-l3"><a class="reference internal" href="functions.html#filter-out">filter-out</a></li>
<li class="toctree-l3"><a class="reference internal" href="functions.html#sort">sort</a></li>
<li class="toctree-l3"><a class="reference internal" href="functions.html#word">word</a></li>
<li class="toctree-l3"><a class="reference internal" href="functions.html#wordlist">wordlist</a></li>
<li class="toctree-l3"><a class="reference internal" href="functions.html#words">words</a></li>
<li class="toctree-l3"><a class="reference internal" href="functions.html#firstword">firstword</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="functions.html#id4">文件名操作函数</a><ul>
<li class="toctree-l3"><a class="reference internal" href="functions.html#dir">dir</a></li>
<li class="toctree-l3"><a class="reference internal" href="functions.html#notdir">notdir</a></li>
<li class="toctree-l3"><a class="reference internal" href="functions.html#suffix">suffix</a></li>
<li class="toctree-l3"><a class="reference internal" href="functions.html#basename">basename</a></li>
<li class="toctree-l3"><a class="reference internal" href="functions.html#addsuffix">addsuffix</a></li>
<li class="toctree-l3"><a class="reference internal" href="functions.html#addprefix">addprefix</a></li>
<li class="toctree-l3"><a class="reference internal" href="functions.html#join">join</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="functions.html#foreach">foreach 函数</a></li>
<li class="toctree-l2"><a class="reference internal" href="functions.html#if">if 函数</a></li>
<li class="toctree-l2"><a class="reference internal" href="functions.html#call">call函数</a></li>
<li class="toctree-l2"><a class="reference internal" href="functions.html#origin">origin函数</a></li>
<li class="toctree-l2"><a class="reference internal" href="functions.html#shell">shell函数</a></li>
<li class="toctree-l2"><a class="reference internal" href="functions.html#make">控制make的函数</a></li>
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="invoke.html">make 的运行</a><ul>
<li class="toctree-l2"><a class="reference internal" href="invoke.html#id1">make的退出码</a></li>
<li class="toctree-l2"><a class="reference internal" href="invoke.html#makefile">指定Makefile</a></li>
<li class="toctree-l2"><a class="reference internal" href="invoke.html#id2">指定目标</a></li>
<li class="toctree-l2"><a class="reference internal" href="invoke.html#id3">检查规则</a></li>
<li class="toctree-l2"><a class="reference internal" href="invoke.html#id4">make的参数</a></li>
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="implicit_rules.html">隐含规则</a><ul>
<li class="toctree-l2"><a class="reference internal" href="implicit_rules.html#id2">使用隐含规则</a></li>
<li class="toctree-l2"><a class="reference internal" href="implicit_rules.html#id3">隐含规则一览</a></li>
<li class="toctree-l2"><a class="reference internal" href="implicit_rules.html#id4">隐含规则使用的变量</a><ul>
<li class="toctree-l3"><a class="reference internal" href="implicit_rules.html#id5">关于命令的变量。</a></li>
<li class="toctree-l3"><a class="reference internal" href="implicit_rules.html#id6">关于命令参数的变量</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="implicit_rules.html#id7">隐含规则链</a></li>
<li class="toctree-l2"><a class="reference internal" href="implicit_rules.html#id8">定义模式规则</a><ul>
<li class="toctree-l3"><a class="reference internal" href="implicit_rules.html#id9">模式规则介绍</a></li>
<li class="toctree-l3"><a class="reference internal" href="implicit_rules.html#id10">模式规则示例</a></li>
<li class="toctree-l3"><a class="reference internal" href="implicit_rules.html#id11">自动化变量</a></li>
<li class="toctree-l3"><a class="reference internal" href="implicit_rules.html#id12">模式的匹配</a></li>
<li class="toctree-l3"><a class="reference internal" href="implicit_rules.html#id13">重载内建隐含规则</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="implicit_rules.html#id14">老式风格的“后缀规则”</a></li>
<li class="toctree-l2"><a class="reference internal" href="implicit_rules.html#id15">隐含规则搜索算法</a></li>
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="archives.html">使用make更新函数库文件</a><ul>
<li class="toctree-l2"><a class="reference internal" href="archives.html#id1">函数库文件的成员</a></li>
<li class="toctree-l2"><a class="reference internal" href="archives.html#id2">函数库成员的隐含规则</a></li>
<li class="toctree-l2"><a class="reference internal" href="archives.html#id3">函数库文件的后缀规则</a></li>
<li class="toctree-l2"><a class="reference internal" href="archives.html#id4">注意事项</a></li>
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="postscript.html">后序</a></li>
</ul>
</div>
</section>
</div>
</div>
<footer><div class="rst-footer-buttons" role="navigation" aria-label="Footer">
<a href="overview.html" class="btn btn-neutral float-right" title="概述" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
</div>
<hr/>
<div role="contentinfo">
<p>&#169; 版权所有 2014-2019, 作者：陈皓；排版：SeisMan.
<span class="lastupdated">最后更新于 2022年5月22日.
</span></p>
</div>
Built with <a href="https://www.sphinx-doc.org/">Sphinx</a> using a
<a href="https://github.com/readthedocs/sphinx_rtd_theme">theme</a>
provided by <a href="https://readthedocs.org">Read the Docs</a>.
</footer>
</div>
</div>
</section>
</div>
<script>
jQuery(function () {
SphinxRtdTheme.Navigation.enable(true);
});
</script>
</body>
</html>

398
introduction.html Normal file
View File

@ -0,0 +1,398 @@
<!DOCTYPE html>
<html class="writer-html5" lang="zh-CN" >
<head>
<meta charset="utf-8" /><meta name="generator" content="Docutils 0.17.1: http://docutils.sourceforge.net/" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<title>makefile介绍 &mdash; 跟我一起写Makefile 1.0 文档</title>
<link rel="stylesheet" href="_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="_static/css/theme.css" type="text/css" />
<!--[if lt IE 9]>
<script src="_static/js/html5shiv.min.js"></script>
<![endif]-->
<script data-url_root="./" id="documentation_options" src="_static/documentation_options.js"></script>
<script src="_static/jquery.js"></script>
<script src="_static/underscore.js"></script>
<script src="_static/doctools.js"></script>
<script src="_static/translations.js"></script>
<script src="_static/js/theme.js"></script>
<link rel="index" title="索引" href="genindex.html" />
<link rel="search" title="搜索" href="search.html" />
<link rel="next" title="书写规则" href="rules.html" />
<link rel="prev" title="概述" href="overview.html" />
</head>
<body class="wy-body-for-nav">
<div class="wy-grid-for-nav">
<nav data-toggle="wy-nav-shift" class="wy-nav-side">
<div class="wy-side-scroll">
<div class="wy-side-nav-search" >
<a href="index.html" class="icon icon-home"> 跟我一起写Makefile
</a>
<div class="version">
1.0
</div>
<div role="search">
<form id="rtd-search-form" class="wy-form" action="search.html" method="get">
<input type="text" name="q" placeholder="Search docs" />
<input type="hidden" name="check_keywords" value="yes" />
<input type="hidden" name="area" value="default" />
</form>
</div>
</div><div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="Navigation menu">
<p class="caption" role="heading"><span class="caption-text">目录</span></p>
<ul class="current">
<li class="toctree-l1"><a class="reference internal" href="overview.html">概述</a></li>
<li class="toctree-l1 current"><a class="current reference internal" href="#">makefile介绍</a><ul>
<li class="toctree-l2"><a class="reference internal" href="#id1">makefile的规则</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id2">一个示例</a></li>
<li class="toctree-l2"><a class="reference internal" href="#make">make是如何工作的</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id3">makefile中使用变量</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id4">让make自动推导</a></li>
<li class="toctree-l2"><a class="reference internal" href="#makefiles">另类风格的makefiles</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id5">清空目标文件的规则</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id6">Makefile里有什么？</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id7">Makefile的文件名</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id8">引用其它的Makefile</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id9">环境变量MAKEFILES</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id10">make的工作方式</a></li>
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="rules.html">书写规则</a></li>
<li class="toctree-l1"><a class="reference internal" href="recipes.html">书写命令</a></li>
<li class="toctree-l1"><a class="reference internal" href="variables.html">使用变量</a></li>
<li class="toctree-l1"><a class="reference internal" href="conditionals.html">使用条件判断</a></li>
<li class="toctree-l1"><a class="reference internal" href="functions.html">使用函数</a></li>
<li class="toctree-l1"><a class="reference internal" href="invoke.html">make 的运行</a></li>
<li class="toctree-l1"><a class="reference internal" href="implicit_rules.html">隐含规则</a></li>
<li class="toctree-l1"><a class="reference internal" href="archives.html">使用make更新函数库文件</a></li>
<li class="toctree-l1"><a class="reference internal" href="postscript.html">后序</a></li>
</ul>
</div>
</div>
</nav>
<section data-toggle="wy-nav-shift" class="wy-nav-content-wrap"><nav class="wy-nav-top" aria-label="Mobile navigation menu" >
<i data-toggle="wy-nav-top" class="fa fa-bars"></i>
<a href="index.html">跟我一起写Makefile</a>
</nav>
<div class="wy-nav-content">
<div class="rst-content">
<div role="navigation" aria-label="Page navigation">
<ul class="wy-breadcrumbs">
<li><a href="index.html" class="icon icon-home"></a> &raquo;</li>
<li>makefile介绍</li>
<li class="wy-breadcrumbs-aside">
<a href="_sources/introduction.rst.txt" rel="nofollow"> View page source</a>
</li>
</ul>
<hr/>
</div>
<div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
<div itemprop="articleBody">
<section id="makefile">
<h1>makefile介绍<a class="headerlink" href="#makefile" title="永久链接至标题"></a></h1>
<p>make命令执行时，需要一个makefile文件，以告诉make命令需要怎么样的去编译和链接程序。</p>
<p>首先，我们用一个示例来说明makefile的书写规则，以便给大家一个感性认识。这个示例来源于gnu
的make使用手册，在这个示例中，我们的工程有8个c文件，和3个头文件，我们要写一个makefile来告诉make命令如何编译和链接这几个文件。我们的规则是：</p>
<ol class="arabic simple">
<li><p>如果这个工程没有编译过，那么我们的所有c文件都要编译并被链接。</p></li>
<li><p>如果这个工程的某几个c文件被修改，那么我们只编译被修改的c文件，并链接目标程序。</p></li>
<li><p>如果这个工程的头文件被改变了，那么我们需要编译引用了这几个头文件的c文件，并链接目标程序。</p></li>
</ol>
<p>只要我们的makefile写得够好，所有的这一切，我们只用一个make命令就可以完成，make命令会自动智能地根据当前的文件修改的情况来确定哪些文件需要重编译，从而自动编译所需要的文件和链接目标程序。</p>
<section id="id1">
<h2>makefile的规则<a class="headerlink" href="#id1" title="永久链接至标题"></a></h2>
<p>在讲述这个makefile之前，还是让我们先来粗略地看一看makefile的规则。</p>
<div class="highlight-makefile notranslate"><div class="highlight"><pre><span></span><span class="nf">target ... </span><span class="o">:</span> <span class="n">prerequisites</span> ...
<span class="nb">command</span>
...
...
</pre></div>
</div>
<dl class="simple">
<dt>target</dt><dd><p>可以是一个object file（目标文件），也可以是一个执行文件，还可以是一个标签（label）。对于标签这种特性，在后续的“伪目标”章节中会有叙述。</p>
</dd>
<dt>prerequisites</dt><dd><p>生成该target所依赖的文件和/或target</p>
</dd>
<dt>command</dt><dd><p>该target要执行的命令（任意的shell命令）</p>
</dd>
</dl>
<p>这是一个文件的依赖关系，也就是说，target这一个或多个的目标文件依赖于prerequisites中的文件，其生成规则定义在command中。说白一点就是说:</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span>prerequisites中如果有一个以上的文件比target文件要新的话，command所定义的命令就会被执行。
</pre></div>
</div>
<p>这就是makefile的规则，也就是makefile中最核心的内容。</p>
<p>说到底，makefile的东西就是这样一点，好像我的这篇文档也该结束了。呵呵。还不尽然，这是makefile
的主线和核心，但要写好一个makefile还不够，我会在后面一点一点地结合我的工作经验给你慢慢道来。内容还多着呢。:)</p>
</section>
<section id="id2">
<h2>一个示例<a class="headerlink" href="#id2" title="永久链接至标题"></a></h2>
<p>正如前面所说，如果一个工程有3个头文件和8个c文件，为了完成前面所述的那三个规则，我们的makefile
应该是下面的这个样子的。</p>
<div class="highlight-makefile notranslate"><div class="highlight"><pre><span></span><span class="nf">edit </span><span class="o">:</span> <span class="n">main</span>.<span class="n">o</span> <span class="n">kbd</span>.<span class="n">o</span> <span class="n">command</span>.<span class="n">o</span> <span class="n">display</span>.<span class="n">o</span> \
<span class="n">insert</span>.<span class="n">o</span> <span class="n">search</span>.<span class="n">o</span> <span class="n">files</span>.<span class="n">o</span> <span class="n">utils</span>.<span class="n">o</span>
cc -o edit main.o kbd.o command.o display.o <span class="se">\</span>
insert.o search.o files.o utils.o
<span class="nf">main.o </span><span class="o">:</span> <span class="n">main</span>.<span class="n">c</span> <span class="n">defs</span>.<span class="n">h</span>
cc -c main.c
<span class="nf">kbd.o </span><span class="o">:</span> <span class="n">kbd</span>.<span class="n">c</span> <span class="n">defs</span>.<span class="n">h</span> <span class="n">command</span>.<span class="n">h</span>
cc -c kbd.c
<span class="nf">command.o </span><span class="o">:</span> <span class="n">command</span>.<span class="n">c</span> <span class="n">defs</span>.<span class="n">h</span> <span class="n">command</span>.<span class="n">h</span>
cc -c command.c
<span class="nf">display.o </span><span class="o">:</span> <span class="n">display</span>.<span class="n">c</span> <span class="n">defs</span>.<span class="n">h</span> <span class="n">buffer</span>.<span class="n">h</span>
cc -c display.c
<span class="nf">insert.o </span><span class="o">:</span> <span class="n">insert</span>.<span class="n">c</span> <span class="n">defs</span>.<span class="n">h</span> <span class="n">buffer</span>.<span class="n">h</span>
cc -c insert.c
<span class="nf">search.o </span><span class="o">:</span> <span class="n">search</span>.<span class="n">c</span> <span class="n">defs</span>.<span class="n">h</span> <span class="n">buffer</span>.<span class="n">h</span>
cc -c search.c
<span class="nf">files.o </span><span class="o">:</span> <span class="n">files</span>.<span class="n">c</span> <span class="n">defs</span>.<span class="n">h</span> <span class="n">buffer</span>.<span class="n">h</span> <span class="n">command</span>.<span class="n">h</span>
cc -c files.c
<span class="nf">utils.o </span><span class="o">:</span> <span class="n">utils</span>.<span class="n">c</span> <span class="n">defs</span>.<span class="n">h</span>
cc -c utils.c
<span class="nf">clean </span><span class="o">:</span>
rm edit main.o kbd.o command.o display.o <span class="se">\</span>
insert.o search.o files.o utils.o
</pre></div>
</div>
<p>反斜杠（ <code class="docutils literal notranslate"><span class="pre">\</span></code> ）是换行符的意思。这样比较便于makefile的阅读。我们可以把这个内容保存在名字为“makefile”或“Makefile”的文件中，然后在该目录下直接输入命令 <code class="docutils literal notranslate"><span class="pre">make</span></code> 就可以生成执行文件edit。如果要删除执行文件和所有的中间目标文件，那么，只要简单地执行一下 <code class="docutils literal notranslate"><span class="pre">make</span> <span class="pre">clean</span></code> 就可以了。</p>
<p>在这个makefile中，目标文件（target）包含：执行文件edit和中间目标文件（ <code class="docutils literal notranslate"><span class="pre">*.o</span></code> ），依赖文件（prerequisites）就是冒号后面的那些 <code class="docutils literal notranslate"><span class="pre">.c</span></code> 文件和 <code class="docutils literal notranslate"><span class="pre">.h</span></code> 文件。每一个 <code class="docutils literal notranslate"><span class="pre">.o</span></code> 文件都有一组依赖文件，而这些 <code class="docutils literal notranslate"><span class="pre">.o</span></code> 文件又是执行文件 <code class="docutils literal notranslate"><span class="pre">edit</span></code> 的依赖文件。依赖关系的实质就是说明了目标文件是由哪些文件生成的，换言之，目标文件是哪些文件更新的。</p>
<p>在定义好依赖关系后，后续的那一行定义了如何生成目标文件的操作系统命令，一定要以一个 <code class="docutils literal notranslate"><span class="pre">Tab</span></code> 键作为开头。记住，make并不管命令是怎么工作的，他只管执行所定义的命令。make会比较targets文件和prerequisites文件的修改日期，如果prerequisites文件的日期要比targets文件的日期要新，或者target不存在的话，那么，make就会执行后续定义的命令。</p>
<p>这里要说明一点的是， <code class="docutils literal notranslate"><span class="pre">clean</span></code> 不是一个文件，它只不过是一个动作名字，有点像c语言中的label一样，其冒号后什么也没有，那么，make就不会自动去找它的依赖性，也就不会自动执行其后所定义的命令。要执行其后的命令，就要在make命令后明显得指出这个label的名字。这样的方法非常有用，我们可以在一个makefile中定义不用的编译或是和编译无关的命令，比如程序的打包，程序的备份，等等。</p>
</section>
<section id="make">
<h2>make是如何工作的<a class="headerlink" href="#make" title="永久链接至标题"></a></h2>
<p>在默认的方式下，也就是我们只输入 <code class="docutils literal notranslate"><span class="pre">make</span></code> 命令。那么，</p>
<ol class="arabic simple">
<li><p>make会在当前目录下找名字叫“Makefile”或“makefile”的文件。</p></li>
<li><p>如果找到，它会找文件中的第一个目标文件（target），在上面的例子中，他会找到“edit”这个文件，并把这个文件作为最终的目标文件。</p></li>
<li><p>如果edit文件不存在，或是edit所依赖的后面的 <code class="docutils literal notranslate"><span class="pre">.o</span></code> 文件的文件修改时间要比 <code class="docutils literal notranslate"><span class="pre">edit</span></code> 这个文件新，那么，他就会执行后面所定义的命令来生成 <code class="docutils literal notranslate"><span class="pre">edit</span></code> 这个文件。</p></li>
<li><p>如果 <code class="docutils literal notranslate"><span class="pre">edit</span></code> 所依赖的 <code class="docutils literal notranslate"><span class="pre">.o</span></code> 文件也不存在，那么make会在当前文件中找目标为 <code class="docutils literal notranslate"><span class="pre">.o</span></code> 文件的依赖性，如果找到则再根据那一个规则生成 <code class="docutils literal notranslate"><span class="pre">.o</span></code> 文件。（这有点像一个堆栈的过程）</p></li>
<li><p>当然，你的C文件和H文件是存在的啦，于是make会生成 <code class="docutils literal notranslate"><span class="pre">.o</span></code> 文件，然后再用 <code class="docutils literal notranslate"><span class="pre">.o</span></code> 文件生成make的终极任务，也就是执行文件 <code class="docutils literal notranslate"><span class="pre">edit</span></code> 了。</p></li>
</ol>
<p>这就是整个make的依赖性，make会一层又一层地去找文件的依赖关系，直到最终编译出第一个目标文件。在找寻的过程中，如果出现错误，比如最后被依赖的文件找不到，那么make就会直接退出，并报错，而对于所定义的命令的错误，或是编译不成功，make根本不理。make只管文件的依赖性，即，如果在我找了依赖关系之后，冒号后面的文件还是不在，那么对不起，我就不工作啦。</p>
<p>通过上述分析，我们知道，像clean这种，没有被第一个目标文件直接或间接关联，那么它后面所定义的命令将不会被自动执行，不过，我们可以显示要make执行。即命令—— <code class="docutils literal notranslate"><span class="pre">make</span> <span class="pre">clean</span></code> ，以此来清除所有的目标文件，以便重编译。</p>
<p>于是在我们编程中，如果这个工程已被编译过了，当我们修改了其中一个源文件，比如 <code class="docutils literal notranslate"><span class="pre">file.c</span></code> ，那么根据我们的依赖性，我们的目标 <code class="docutils literal notranslate"><span class="pre">file.o</span></code> 会被重编译（也就是在这个依性关系后面所定义的命令），于是 <code class="docutils literal notranslate"><span class="pre">file.o</span></code> 的文件也是最新的啦，于是 <code class="docutils literal notranslate"><span class="pre">file.o</span></code> 的文件修改时间要比 <code class="docutils literal notranslate"><span class="pre">edit</span></code> 要新，所以 <code class="docutils literal notranslate"><span class="pre">edit</span></code> 也会被重新链接了（详见 <code class="docutils literal notranslate"><span class="pre">edit</span></code> 目标文件后定义的命令）。</p>
<p>而如果我们改变了 <code class="docutils literal notranslate"><span class="pre">command.h</span></code> ，那么， <code class="docutils literal notranslate"><span class="pre">kdb.o</span></code> 、 <code class="docutils literal notranslate"><span class="pre">command.o</span></code> 和 <code class="docutils literal notranslate"><span class="pre">files.o</span></code> 都会被重编译，并且， <code class="docutils literal notranslate"><span class="pre">edit</span></code> 会被重链接。</p>
</section>
<section id="id3">
<h2>makefile中使用变量<a class="headerlink" href="#id3" title="永久链接至标题"></a></h2>
<p>在上面的例子中，先让我们看看edit的规则：</p>
<div class="highlight-makefile notranslate"><div class="highlight"><pre><span></span><span class="nf">edit </span><span class="o">:</span> <span class="n">main</span>.<span class="n">o</span> <span class="n">kbd</span>.<span class="n">o</span> <span class="n">command</span>.<span class="n">o</span> <span class="n">display</span>.<span class="n">o</span> \
<span class="n">insert</span>.<span class="n">o</span> <span class="n">search</span>.<span class="n">o</span> <span class="n">files</span>.<span class="n">o</span> <span class="n">utils</span>.<span class="n">o</span>
cc -o edit main.o kbd.o command.o display.o <span class="se">\</span>
insert.o search.o files.o utils.o
</pre></div>
</div>
<p>我们可以看到 <code class="docutils literal notranslate"><span class="pre">.o</span></code> 文件的字符串被重复了两次，如果我们的工程需要加入一个新的 <code class="docutils literal notranslate"><span class="pre">.o</span></code> 文件，那么我们需要在两个地方加（应该是三个地方，还有一个地方在clean中）。当然，我们的makefile并不复杂，所以在两个地方加也不累，但如果makefile变得复杂，那么我们就有可能会忘掉一个需要加入的地方，而导致编译失败。所以，为了makefile的易维护，在makefile中我们可以使用变量。makefile的变量也就是一个字符串，理解成C语言中的宏可能会更好。</p>
<p>比如，我们声明一个变量，叫 <code class="docutils literal notranslate"><span class="pre">objects</span></code> ， <code class="docutils literal notranslate"><span class="pre">OBJECTS</span></code> ， <code class="docutils literal notranslate"><span class="pre">objs</span></code> ， <code class="docutils literal notranslate"><span class="pre">OBJS</span></code> ，
<code class="docutils literal notranslate"><span class="pre">obj</span></code> 或是 <code class="docutils literal notranslate"><span class="pre">OBJ</span></code> ，反正不管什么啦，只要能够表示obj文件就行了。我们在makefile一开始就这样定义：</p>
<div class="highlight-makefile notranslate"><div class="highlight"><pre><span></span><span class="nv">objects</span> <span class="o">=</span> main.o kbd.o command.o display.o <span class="se">\</span>
insert.o search.o files.o utils.o
</pre></div>
</div>
<p>于是，我们就可以很方便地在我们的makefile中以 <code class="docutils literal notranslate"><span class="pre">$(objects)</span></code> 的方式来使用这个变量了，于是我们的改良版makefile就变成下面这个样子：</p>
<div class="highlight-makefile notranslate"><div class="highlight"><pre><span></span><span class="nv">objects</span> <span class="o">=</span> main.o kbd.o command.o display.o <span class="se">\</span>
insert.o search.o files.o utils.o
<span class="nf">edit </span><span class="o">:</span> <span class="k">$(</span><span class="nv">objects</span><span class="k">)</span>
cc -o edit <span class="k">$(</span>objects<span class="k">)</span>
<span class="nf">main.o </span><span class="o">:</span> <span class="n">main</span>.<span class="n">c</span> <span class="n">defs</span>.<span class="n">h</span>
cc -c main.c
<span class="nf">kbd.o </span><span class="o">:</span> <span class="n">kbd</span>.<span class="n">c</span> <span class="n">defs</span>.<span class="n">h</span> <span class="n">command</span>.<span class="n">h</span>
cc -c kbd.c
<span class="nf">command.o </span><span class="o">:</span> <span class="n">command</span>.<span class="n">c</span> <span class="n">defs</span>.<span class="n">h</span> <span class="n">command</span>.<span class="n">h</span>
cc -c command.c
<span class="nf">display.o </span><span class="o">:</span> <span class="n">display</span>.<span class="n">c</span> <span class="n">defs</span>.<span class="n">h</span> <span class="n">buffer</span>.<span class="n">h</span>
cc -c display.c
<span class="nf">insert.o </span><span class="o">:</span> <span class="n">insert</span>.<span class="n">c</span> <span class="n">defs</span>.<span class="n">h</span> <span class="n">buffer</span>.<span class="n">h</span>
cc -c insert.c
<span class="nf">search.o </span><span class="o">:</span> <span class="n">search</span>.<span class="n">c</span> <span class="n">defs</span>.<span class="n">h</span> <span class="n">buffer</span>.<span class="n">h</span>
cc -c search.c
<span class="nf">files.o </span><span class="o">:</span> <span class="n">files</span>.<span class="n">c</span> <span class="n">defs</span>.<span class="n">h</span> <span class="n">buffer</span>.<span class="n">h</span> <span class="n">command</span>.<span class="n">h</span>
cc -c files.c
<span class="nf">utils.o </span><span class="o">:</span> <span class="n">utils</span>.<span class="n">c</span> <span class="n">defs</span>.<span class="n">h</span>
cc -c utils.c
<span class="nf">clean </span><span class="o">:</span>
rm edit <span class="k">$(</span>objects<span class="k">)</span>
</pre></div>
</div>
<p>于是如果有新的 <code class="docutils literal notranslate"><span class="pre">.o</span></code> 文件加入，我们只需简单地修改一下 <code class="docutils literal notranslate"><span class="pre">objects</span></code> 变量就可以了。</p>
<p>关于变量更多的话题，我会在后续给你一一道来。</p>
</section>
<section id="id4">
<h2>让make自动推导<a class="headerlink" href="#id4" title="永久链接至标题"></a></h2>
<p>GNU的make很强大，它可以自动推导文件以及文件依赖关系后面的命令，于是我们就没必要去在每一个
<code class="docutils literal notranslate"><span class="pre">.o</span></code> 文件后都写上类似的命令，因为，我们的make会自动识别，并自己推导命令。</p>
<p>只要make看到一个 <code class="docutils literal notranslate"><span class="pre">.o</span></code> 文件，它就会自动的把 <code class="docutils literal notranslate"><span class="pre">.c</span></code> 文件加在依赖关系中，如果make找到一个
<code class="docutils literal notranslate"><span class="pre">whatever.o</span></code> ，那么 <code class="docutils literal notranslate"><span class="pre">whatever.c</span></code> 就会是 <code class="docutils literal notranslate"><span class="pre">whatever.o</span></code> 的依赖文件。并且
<code class="docutils literal notranslate"><span class="pre">cc</span> <span class="pre">-c</span> <span class="pre">whatever.c</span></code> 也会被推导出来，于是，我们的makefile再也不用写得这么复杂。我们的新makefile又出炉了。</p>
<div class="highlight-makefile notranslate"><div class="highlight"><pre><span></span><span class="nv">objects</span> <span class="o">=</span> main.o kbd.o command.o display.o <span class="se">\</span>
insert.o search.o files.o utils.o
<span class="nf">edit </span><span class="o">:</span> <span class="k">$(</span><span class="nv">objects</span><span class="k">)</span>
cc -o edit <span class="k">$(</span>objects<span class="k">)</span>
<span class="nf">main.o </span><span class="o">:</span> <span class="n">defs</span>.<span class="n">h</span>
<span class="nf">kbd.o </span><span class="o">:</span> <span class="n">defs</span>.<span class="n">h</span> <span class="n">command</span>.<span class="n">h</span>
<span class="nf">command.o </span><span class="o">:</span> <span class="n">defs</span>.<span class="n">h</span> <span class="n">command</span>.<span class="n">h</span>
<span class="nf">display.o </span><span class="o">:</span> <span class="n">defs</span>.<span class="n">h</span> <span class="n">buffer</span>.<span class="n">h</span>
<span class="nf">insert.o </span><span class="o">:</span> <span class="n">defs</span>.<span class="n">h</span> <span class="n">buffer</span>.<span class="n">h</span>
<span class="nf">search.o </span><span class="o">:</span> <span class="n">defs</span>.<span class="n">h</span> <span class="n">buffer</span>.<span class="n">h</span>
<span class="nf">files.o </span><span class="o">:</span> <span class="n">defs</span>.<span class="n">h</span> <span class="n">buffer</span>.<span class="n">h</span> <span class="n">command</span>.<span class="n">h</span>
<span class="nf">utils.o </span><span class="o">:</span> <span class="n">defs</span>.<span class="n">h</span>
<span class="nf">.PHONY </span><span class="o">:</span> <span class="n">clean</span>
<span class="nf">clean </span><span class="o">:</span>
rm edit <span class="k">$(</span>objects<span class="k">)</span>
</pre></div>
</div>
<p>这种方法，也就是make的“隐晦规则”。上面文件内容中， <code class="docutils literal notranslate"><span class="pre">.PHONY</span></code> 表示 <code class="docutils literal notranslate"><span class="pre">clean</span></code> 是个伪目标文件。</p>
<p>关于更为详细的“隐晦规则”和“伪目标文件”，我会在后续给你一一道来。</p>
</section>
<section id="makefiles">
<h2>另类风格的makefiles<a class="headerlink" href="#makefiles" title="永久链接至标题"></a></h2>
<p>既然我们的make可以自动推导命令，那么我看到那堆 <code class="docutils literal notranslate"><span class="pre">.o</span></code> 和 <code class="docutils literal notranslate"><span class="pre">.h</span></code> 的依赖就有点不爽，那么多的重复的 <code class="docutils literal notranslate"><span class="pre">.h</span></code> ，能不能把其收拢起来，好吧，没有问题，这个对于make来说很容易，谁叫它提供了自动推导命令和文件的功能呢？来看看最新风格的makefile吧。</p>
<div class="highlight-makefile notranslate"><div class="highlight"><pre><span></span><span class="nv">objects</span> <span class="o">=</span> main.o kbd.o command.o display.o <span class="se">\</span>
insert.o search.o files.o utils.o
<span class="nf">edit </span><span class="o">:</span> <span class="k">$(</span><span class="nv">objects</span><span class="k">)</span>
cc -o edit <span class="k">$(</span>objects<span class="k">)</span>
<span class="nf">$(objects) </span><span class="o">:</span> <span class="n">defs</span>.<span class="n">h</span>
<span class="nf">kbd.o command.o files.o </span><span class="o">:</span> <span class="n">command</span>.<span class="n">h</span>
<span class="nf">display.o insert.o search.o files.o </span><span class="o">:</span> <span class="n">buffer</span>.<span class="n">h</span>
<span class="nf">.PHONY </span><span class="o">:</span> <span class="n">clean</span>
<span class="nf">clean </span><span class="o">:</span>
rm edit <span class="k">$(</span>objects<span class="k">)</span>
</pre></div>
</div>
<p>这种风格，让我们的makefile变得很简单，但我们的文件依赖关系就显得有点凌乱了。鱼和熊掌不可兼得。还看你的喜好了。我是不喜欢这种风格的，一是文件的依赖关系看不清楚，二是如果文件一多，要加入几个新的 <code class="docutils literal notranslate"><span class="pre">.o</span></code> 文件，那就理不清楚了。</p>
</section>
<section id="id5">
<h2>清空目标文件的规则<a class="headerlink" href="#id5" title="永久链接至标题"></a></h2>
<p>每个Makefile中都应该写一个清空目标文件（ <code class="docutils literal notranslate"><span class="pre">.o</span></code> 和执行文件）的规则，这不仅便于重编译，也很利于保持文件的清洁。这是一个“修养”（呵呵，还记得我的《编程修养》吗）。一般的风格都是：</p>
<div class="highlight-makefile notranslate"><div class="highlight"><pre><span></span><span class="nf">clean</span><span class="o">:</span>
rm edit <span class="k">$(</span>objects<span class="k">)</span>
</pre></div>
</div>
<p>更为稳健的做法是：</p>
<div class="highlight-makefile notranslate"><div class="highlight"><pre><span></span><span class="nf">.PHONY </span><span class="o">:</span> <span class="n">clean</span>
<span class="nf">clean </span><span class="o">:</span>
-rm edit <span class="k">$(</span>objects<span class="k">)</span>
</pre></div>
</div>
<p>前面说过， <code class="docutils literal notranslate"><span class="pre">.PHONY</span></code> 表示 <code class="docutils literal notranslate"><span class="pre">clean</span></code> 是一个“伪目标”。而在 <code class="docutils literal notranslate"><span class="pre">rm</span></code> 命令前面加了一个小减号的意思就是，也许某些文件出现问题，但不要管，继续做后面的事。当然， <code class="docutils literal notranslate"><span class="pre">clean</span></code> 的规则不要放在文件的开头，不然，这就会变成make的默认目标，相信谁也不愿意这样。不成文的规矩是——“clean从来都是放在文件的最后”。</p>
<p>上面就是一个makefile的概貌，也是makefile的基础，下面还有很多makefile的相关细节，准备好了吗？准备好了就来。</p>
</section>
<section id="id6">
<h2>Makefile里有什么？<a class="headerlink" href="#id6" title="永久链接至标题"></a></h2>
<p>Makefile里主要包含了五个东西：显式规则、隐晦规则、变量定义、文件指示和注释。</p>
<ol class="arabic simple">
<li><p>显式规则。显式规则说明了如何生成一个或多个目标文件。这是由Makefile的书写者明显指出要生成的文件、文件的依赖文件和生成的命令。</p></li>
<li><p>隐晦规则。由于我们的make有自动推导的功能，所以隐晦的规则可以让我们比较简略地书写
Makefile，这是由make所支持的。</p></li>
<li><p>变量的定义。在Makefile中我们要定义一系列的变量，变量一般都是字符串，这个有点像你C语言中的宏，当Makefile被执行时，其中的变量都会被扩展到相应的引用位置上。</p></li>
<li><p>文件指示。其包括了三个部分，一个是在一个Makefile中引用另一个Makefile，就像C语言中的include一样；另一个是指根据某些情况指定Makefile中的有效部分，就像C语言中的预编译#if一样；还有就是定义一个多行的命令。有关这一部分的内容，我会在后续的部分中讲述。</p></li>
<li><p>注释。Makefile中只有行注释，和UNIX的Shell脚本一样，其注释是用 <code class="docutils literal notranslate"><span class="pre">#</span></code> 字符，这个就像C/C++中的 <code class="docutils literal notranslate"><span class="pre">//</span></code> 一样。如果你要在你的Makefile中使用 <code class="docutils literal notranslate"><span class="pre">#</span></code> 字符，可以用反斜杠进行转义，如： <code class="docutils literal notranslate"><span class="pre">\#</span></code> 。</p></li>
</ol>
<p>最后，还值得一提的是，在Makefile中的命令，必须要以 <code class="docutils literal notranslate"><span class="pre">Tab</span></code> 键开始。</p>
</section>
<section id="id7">
<h2>Makefile的文件名<a class="headerlink" href="#id7" title="永久链接至标题"></a></h2>
<p>默认的情况下，make命令会在当前目录下按顺序找寻文件名为“GNUmakefile”、“makefile”、“Makefile”的文件，找到了解释这个文件。在这三个文件名中，最好使用“Makefile”这个文件名，因为，这个文件名第一个字符为大写，这样有一种显目的感觉。最好不要用“GNUmakefile”，这个文件是GNU的make识别的。有另外一些make只对全小写的“makefile”文件名敏感，但是基本上来说，大多数的make都支持“makefile”和“Makefile”这两种默认文件名。</p>
<p>当然，你可以使用别的文件名来书写Makefile，比如：“Make.Linux”，“Make.Solaris”，“Make.AIX”等，如果要指定特定的Makefile，你可以使用make的 <code class="docutils literal notranslate"><span class="pre">-f</span></code> 和 <code class="docutils literal notranslate"><span class="pre">--file</span></code> 参数，如： <code class="docutils literal notranslate"><span class="pre">make</span> <span class="pre">-f</span> <span class="pre">Make.Linux</span></code> 或 <code class="docutils literal notranslate"><span class="pre">make</span> <span class="pre">--file</span> <span class="pre">Make.AIX</span></code> 。</p>
</section>
<section id="id8">
<h2>引用其它的Makefile<a class="headerlink" href="#id8" title="永久链接至标题"></a></h2>
<p>在Makefile使用 <code class="docutils literal notranslate"><span class="pre">include</span></code> 关键字可以把别的Makefile包含进来，这很像C语言的
<code class="docutils literal notranslate"><span class="pre">#include</span></code> ，被包含的文件会原模原样的放在当前文件的包含位置。 <code class="docutils literal notranslate"><span class="pre">include</span></code> 的语法是：</p>
<div class="highlight-makefile notranslate"><div class="highlight"><pre><span></span><span class="cp">include &lt;filename&gt;</span>
</pre></div>
</div>
<p><code class="docutils literal notranslate"><span class="pre">filename</span></code> 可以是当前操作系统Shell的文件模式（可以包含路径和通配符）。</p>
<p>在 <code class="docutils literal notranslate"><span class="pre">include</span></code> 前面可以有一些空字符，但是绝不能是 <code class="docutils literal notranslate"><span class="pre">Tab</span></code> 键开始。 <code class="docutils literal notranslate"><span class="pre">include</span></code> 和
<code class="docutils literal notranslate"><span class="pre">&lt;filename&gt;</span></code> 可以用一个或多个空格隔开。举个例子，你有这样几个Makefile： <code class="docutils literal notranslate"><span class="pre">a.mk</span></code> 、
<code class="docutils literal notranslate"><span class="pre">b.mk</span></code> 、 <code class="docutils literal notranslate"><span class="pre">c.mk</span></code> ，还有一个文件叫 <code class="docutils literal notranslate"><span class="pre">foo.make</span></code> ，以及一个变量 <code class="docutils literal notranslate"><span class="pre">$(bar)</span></code> ，其包含了 <code class="docutils literal notranslate"><span class="pre">e.mk</span></code> 和 <code class="docutils literal notranslate"><span class="pre">f.mk</span></code> ，那么，下面的语句：</p>
<div class="highlight-makefile notranslate"><div class="highlight"><pre><span></span><span class="cp">include foo.make *.mk $(bar)</span>
</pre></div>
</div>
<p>等价于：</p>
<div class="highlight-makefile notranslate"><div class="highlight"><pre><span></span><span class="cp">include foo.make a.mk b.mk c.mk e.mk f.mk</span>
</pre></div>
</div>
<p>make命令开始时，会找寻 <code class="docutils literal notranslate"><span class="pre">include</span></code> 所指出的其它Makefile，并把其内容安置在当前的位置。就好像C/C++的 <code class="docutils literal notranslate"><span class="pre">#include</span></code> 指令一样。如果文件都没有指定绝对路径或是相对路径的话，make会在当前目录下首先寻找，如果当前目录下没有找到，那么，make还会在下面的几个目录下找：</p>
<ol class="arabic simple">
<li><p>如果make执行时，有 <code class="docutils literal notranslate"><span class="pre">-I</span></code> 或 <code class="docutils literal notranslate"><span class="pre">--include-dir</span></code> 参数，那么make就会在这个参数所指定的目录下去寻找。</p></li>
<li><p>如果目录 <code class="docutils literal notranslate"><span class="pre">&lt;prefix&gt;/include</span></code> （一般是： <code class="docutils literal notranslate"><span class="pre">/usr/local/bin</span></code> 或
<code class="docutils literal notranslate"><span class="pre">/usr/include</span></code> ）存在的话，make也会去找。</p></li>
</ol>
<p>如果有文件没有找到的话，make会生成一条警告信息，但不会马上出现致命错误。它会继续载入其它的文件，一旦完成makefile的读取，make会再重试这些没有找到，或是不能读取的文件，如果还是不行，make才会出现一条致命信息。如果你想让make不理那些无法读取的文件，而继续执行，你可以在include前加一个减号“-”。如：</p>
<div class="highlight-makefile notranslate"><div class="highlight"><pre><span></span><span class="cp">-include &lt;filename&gt;</span>
</pre></div>
</div>
<p>其表示，无论include过程中出现什么错误，都不要报错继续执行。和其它版本make兼容的相关命令是sinclude，其作用和这一个是一样的。</p>
</section>
<section id="id9">
<h2>环境变量MAKEFILES<a class="headerlink" href="#id9" title="永久链接至标题"></a></h2>
<p>如果你的当前环境中定义了环境变量 <code class="docutils literal notranslate"><span class="pre">MAKEFILES</span></code> ，那么，make会把这个变量中的值做一个类似于
<code class="docutils literal notranslate"><span class="pre">include</span></code> 的动作。这个变量中的值是其它的Makefile，用空格分隔。只是，它和 <code class="docutils literal notranslate"><span class="pre">include</span></code> 不同的是，从这个环境变量中引入的Makefile的“目标”不会起作用，如果环境变量中定义的文件发现错误，make也会不理。</p>
<p>但是在这里我还是建议不要使用这个环境变量，因为只要这个变量一被定义，那么当你使用make时，所有的Makefile都会受到它的影响，这绝不是你想看到的。在这里提这个事，只是为了告诉大家，也许有时候你的Makefile出现了怪事，那么你可以看看当前环境中有没有定义这个变量。</p>
</section>
<section id="id10">
<h2>make的工作方式<a class="headerlink" href="#id10" title="永久链接至标题"></a></h2>
<p>GNU的make工作时的执行步骤如下：（想来其它的make也是类似）</p>
<ol class="arabic simple">
<li><p>读入所有的Makefile。</p></li>
<li><p>读入被include的其它Makefile。</p></li>
<li><p>初始化文件中的变量。</p></li>
<li><p>推导隐晦规则，并分析所有规则。</p></li>
<li><p>为所有的目标文件创建依赖关系链。</p></li>
<li><p>根据依赖关系，决定哪些目标要重新生成。</p></li>
<li><p>执行生成命令。</p></li>
</ol>
<p>1-5步为第一个阶段，6-7为第二个阶段。第一个阶段中，如果定义的变量被使用了，那么，make会把其展开在使用的位置。但make并不会完全马上展开，make使用的是拖延战术，如果变量出现在依赖关系的规则中，那么仅当这条依赖被决定要使用了，变量才会在其内部展开。</p>
<p>当然，这个工作方式你不一定要清楚，但是知道这个方式你也会对make更为熟悉。有了这个基础，后续部分也就容易看懂了。</p>
</section>
</section>
</div>
</div>
<footer><div class="rst-footer-buttons" role="navigation" aria-label="Footer">
<a href="overview.html" class="btn btn-neutral float-left" title="概述" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
<a href="rules.html" class="btn btn-neutral float-right" title="书写规则" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
</div>
<hr/>
<div role="contentinfo">
<p>&#169; 版权所有 2014-2019, 作者：陈皓；排版：SeisMan.
<span class="lastupdated">最后更新于 2022年5月22日.
</span></p>
</div>
Built with <a href="https://www.sphinx-doc.org/">Sphinx</a> using a
<a href="https://github.com/readthedocs/sphinx_rtd_theme">theme</a>
provided by <a href="https://readthedocs.org">Read the Docs</a>.
</footer>
</div>
</div>
</section>
</div>
<script>
jQuery(function () {
SphinxRtdTheme.Navigation.enable(true);
});
</script>
</body>
</html>

265
invoke.html Normal file
View File

@ -0,0 +1,265 @@
<!DOCTYPE html>
<html class="writer-html5" lang="zh-CN" >
<head>
<meta charset="utf-8" /><meta name="generator" content="Docutils 0.17.1: http://docutils.sourceforge.net/" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<title>make 的运行 &mdash; 跟我一起写Makefile 1.0 文档</title>
<link rel="stylesheet" href="_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="_static/css/theme.css" type="text/css" />
<!--[if lt IE 9]>
<script src="_static/js/html5shiv.min.js"></script>
<![endif]-->
<script data-url_root="./" id="documentation_options" src="_static/documentation_options.js"></script>
<script src="_static/jquery.js"></script>
<script src="_static/underscore.js"></script>
<script src="_static/doctools.js"></script>
<script src="_static/translations.js"></script>
<script src="_static/js/theme.js"></script>
<link rel="index" title="索引" href="genindex.html" />
<link rel="search" title="搜索" href="search.html" />
<link rel="next" title="隐含规则" href="implicit_rules.html" />
<link rel="prev" title="使用函数" href="functions.html" />
</head>
<body class="wy-body-for-nav">
<div class="wy-grid-for-nav">
<nav data-toggle="wy-nav-shift" class="wy-nav-side">
<div class="wy-side-scroll">
<div class="wy-side-nav-search" >
<a href="index.html" class="icon icon-home"> 跟我一起写Makefile
</a>
<div class="version">
1.0
</div>
<div role="search">
<form id="rtd-search-form" class="wy-form" action="search.html" method="get">
<input type="text" name="q" placeholder="Search docs" />
<input type="hidden" name="check_keywords" value="yes" />
<input type="hidden" name="area" value="default" />
</form>
</div>
</div><div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="Navigation menu">
<p class="caption" role="heading"><span class="caption-text">目录</span></p>
<ul class="current">
<li class="toctree-l1"><a class="reference internal" href="overview.html">概述</a></li>
<li class="toctree-l1"><a class="reference internal" href="introduction.html">makefile介绍</a></li>
<li class="toctree-l1"><a class="reference internal" href="rules.html">书写规则</a></li>
<li class="toctree-l1"><a class="reference internal" href="recipes.html">书写命令</a></li>
<li class="toctree-l1"><a class="reference internal" href="variables.html">使用变量</a></li>
<li class="toctree-l1"><a class="reference internal" href="conditionals.html">使用条件判断</a></li>
<li class="toctree-l1"><a class="reference internal" href="functions.html">使用函数</a></li>
<li class="toctree-l1 current"><a class="current reference internal" href="#">make 的运行</a><ul>
<li class="toctree-l2"><a class="reference internal" href="#id1">make的退出码</a></li>
<li class="toctree-l2"><a class="reference internal" href="#makefile">指定Makefile</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id2">指定目标</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id3">检查规则</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id4">make的参数</a></li>
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="implicit_rules.html">隐含规则</a></li>
<li class="toctree-l1"><a class="reference internal" href="archives.html">使用make更新函数库文件</a></li>
<li class="toctree-l1"><a class="reference internal" href="postscript.html">后序</a></li>
</ul>
</div>
</div>
</nav>
<section data-toggle="wy-nav-shift" class="wy-nav-content-wrap"><nav class="wy-nav-top" aria-label="Mobile navigation menu" >
<i data-toggle="wy-nav-top" class="fa fa-bars"></i>
<a href="index.html">跟我一起写Makefile</a>
</nav>
<div class="wy-nav-content">
<div class="rst-content">
<div role="navigation" aria-label="Page navigation">
<ul class="wy-breadcrumbs">
<li><a href="index.html" class="icon icon-home"></a> &raquo;</li>
<li>make 的运行</li>
<li class="wy-breadcrumbs-aside">
<a href="_sources/invoke.rst.txt" rel="nofollow"> View page source</a>
</li>
</ul>
<hr/>
</div>
<div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
<div itemprop="articleBody">
<section id="make">
<h1>make 的运行<a class="headerlink" href="#make" title="永久链接至标题"></a></h1>
<p>一般来说，最简单的就是直接在命令行下输入make命令，make命令会找当前目录的makefile来执行，一切都是自动的。但也有时你也许只想让make重编译某些文件，而不是整个工程，而又有的时候你有几套编译规则，你想在不同的时候使用不同的编译规则，等等。本章节就是讲述如何使用make命令的。</p>
<section id="id1">
<h2>make的退出码<a class="headerlink" href="#id1" title="永久链接至标题"></a></h2>
<p>make命令执行后有三个退出码：</p>
<dl class="simple">
<dt>0</dt><dd><p>表示成功执行。</p>
</dd>
<dt>1</dt><dd><p>如果make运行时出现任何错误，其返回1。</p>
</dd>
<dt>2</dt><dd><p>如果你使用了make的“-q”选项，并且make使得一些目标不需要更新，那么返回2。</p>
</dd>
</dl>
<p>Make的相关参数我们会在后续章节中讲述。</p>
</section>
<section id="makefile">
<h2>指定Makefile<a class="headerlink" href="#makefile" title="永久链接至标题"></a></h2>
<p>前面我们说过，GNU make找寻默认的Makefile的规则是在当前目录下依次找三个文件——“GNUmakefile”、“makefile”和“Makefile”。其按顺序找这三个文件，一旦找到，就开始读取这个文件并执行。</p>
<p>当前，我们也可以给make命令指定一个特殊名字的Makefile。要达到这个功能，我们要使用make的
<code class="docutils literal notranslate"><span class="pre">-f</span></code> 或是 <code class="docutils literal notranslate"><span class="pre">--file</span></code> 参数（ <code class="docutils literal notranslate"><span class="pre">--makefile</span></code> 参数也行）。例如，我们有个makefile的名字是“hchen.mk”，那么，我们可以这样来让make来执行这个文件：</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span>make –f hchen.mk
</pre></div>
</div>
<p>如果在make的命令行是，你不只一次地使用了 <code class="docutils literal notranslate"><span class="pre">-f</span></code> 参数，那么，所有指定的makefile将会被连在一起传递给make执行。</p>
</section>
<section id="id2">
<h2>指定目标<a class="headerlink" href="#id2" title="永久链接至标题"></a></h2>
<p>一般来说，make的最终目标是makefile中的第一个目标，而其它目标一般是由这个目标连带出来的。这是make的默认行为。当然，一般来说，你的makefile中的第一个目标是由许多个目标组成，你可以指示make，让其完成你所指定的目标。要达到这一目的很简单，需在make命令后直接跟目标的名字就可以完成（如前面提到的“make clean”形式）</p>
<p>任何在makefile中的目标都可以被指定成终极目标，但是除了以 <code class="docutils literal notranslate"><span class="pre">-</span></code> 打头，或是包含了 <code class="docutils literal notranslate"><span class="pre">=</span></code> 的目标，因为有这些字符的目标，会被解析成命令行参数或是变量。甚至没有被我们明确写出来的目标也可以成为make的终极目标，也就是说，只要make可以找到其隐含规则推导规则，那么这个隐含目标同样可以被指定成终极目标。</p>
<p>有一个make的环境变量叫 <code class="docutils literal notranslate"><span class="pre">MAKECMDGOALS</span></code> ，这个变量中会存放你所指定的终极目标的列表，如果在命令行上，你没有指定目标，那么，这个变量是空值。这个变量可以让你使用在一些比较特殊的情形下。比如下面的例子：</p>
<div class="highlight-makefile notranslate"><div class="highlight"><pre><span></span><span class="nv">sources</span> <span class="o">=</span> foo.c bar.c
<span class="cp">ifneq ( $(MAKECMDGOALS),clean)</span>
<span class="cp"> include $(sources:.c=.d)</span>
<span class="cp">endif</span>
</pre></div>
</div>
<p>基于上面的这个例子，只要我们输入的命令不是“make clean”，那么makefile会自动包含“foo.d”和“bar.d”这两个makefile。</p>
<p>使用指定终极目标的方法可以很方便地让我们编译我们的程序，例如下面这个例子：</p>
<div class="highlight-makefile notranslate"><div class="highlight"><pre><span></span><span class="nf">.PHONY</span><span class="o">:</span> <span class="n">all</span>
<span class="nf">all</span><span class="o">:</span> <span class="n">prog</span>1 <span class="n">prog</span>2 <span class="n">prog</span>3 <span class="n">prog</span>4
</pre></div>
</div>
<p>从这个例子中，我们可以看到，这个makefile中有四个需要编译的程序——“prog1”， “prog2”，“prog3”和 “prog4”，我们可以使用“make all”命令来编译所有的目标（如果把all置成第一个目标，那么只需执行“make”），我们也可以使用 “make prog2”来单独编译目标“prog2”。</p>
<p>即然make可以指定所有makefile中的目标，那么也包括“伪目标”，于是我们可以根据这种性质来让我们的makefile根据指定的不同的目标来完成不同的事。在Unix世界中，软件发布时，特别是GNU这种开源软件的发布时，其makefile都包含了编译、安装、打包等功能。我们可以参照这种规则来书写我们的makefile中的目标。</p>
<ul class="simple">
<li><p>all:这个伪目标是所有目标的目标，其功能一般是编译所有的目标。</p></li>
<li><p>clean:这个伪目标功能是删除所有被make创建的文件。</p></li>
<li><p>install:这个伪目标功能是安装已编译好的程序，其实就是把目标执行文件拷贝到指定的目标中去。</p></li>
<li><p>print:这个伪目标的功能是例出改变过的源文件。</p></li>
<li><p>tar:这个伪目标功能是把源程序打包备份。也就是一个tar文件。</p></li>
<li><p>dist:这个伪目标功能是创建一个压缩文件，一般是把tar文件压成Z文件。或是gz文件。</p></li>
<li><p>TAGS:这个伪目标功能是更新所有的目标，以备完整地重编译使用。</p></li>
<li><p>check和test:这两个伪目标一般用来测试makefile的流程。</p></li>
</ul>
<p>当然一个项目的makefile中也不一定要书写这样的目标，这些东西都是GNU的东西，但是我想，GNU搞出这些东西一定有其可取之处（等你的 UNIX下的程序文件一多时你就会发现这些功能很有用了），这里只不过是说明了，如果你要书写这种功能，最好使用这种名字命名你的目标，这样规范一些，规范的好处就是——不用解释，大家都明白。而且如果你的makefile中有这些功能，一是很实用，二是可以显得你的makefile很专业（不是那种初学者的作品）。</p>
</section>
<section id="id3">
<h2>检查规则<a class="headerlink" href="#id3" title="永久链接至标题"></a></h2>
<p>有时候，我们不想让我们的makefile中的规则执行起来，我们只想检查一下我们的命令，或是执行的序列。于是我们可以使用make命令的下述参数：</p>
<dl class="simple">
<dt><code class="docutils literal notranslate"><span class="pre">-n</span></code>, <code class="docutils literal notranslate"><span class="pre">--just-print</span></code>, <code class="docutils literal notranslate"><span class="pre">--dry-run</span></code>, <code class="docutils literal notranslate"><span class="pre">--recon</span></code></dt><dd><p>不执行参数，这些参数只是打印命令，不管目标是否更新，把规则和连带规则下的命令打印出来，但不执行，这些参数对于我们调试makefile很有用处。</p>
</dd>
<dt><code class="docutils literal notranslate"><span class="pre">-t</span></code>, <code class="docutils literal notranslate"><span class="pre">--touch</span></code></dt><dd><p>这个参数的意思就是把目标文件的时间更新，但不更改目标文件。也就是说，make假装编译目标，但不是真正的编译目标，只是把目标变成已编译过的状态。</p>
</dd>
<dt><code class="docutils literal notranslate"><span class="pre">-q</span></code>, <code class="docutils literal notranslate"><span class="pre">--question</span></code></dt><dd><p>这个参数的行为是找目标的意思，也就是说，如果目标存在，那么其什么也不会输出，当然也不会执行编译，如果目标不存在，其会打印出一条出错信息。</p>
</dd>
<dt><code class="docutils literal notranslate"><span class="pre">-W</span> <span class="pre">&lt;file&gt;</span></code>, <code class="docutils literal notranslate"><span class="pre">--what-if=&lt;file&gt;</span></code>, <code class="docutils literal notranslate"><span class="pre">--assume-new=&lt;file&gt;</span></code>, <code class="docutils literal notranslate"><span class="pre">--new-file=&lt;file&gt;</span></code></dt><dd><p>这个参数需要指定一个文件。一般是是源文件（或依赖文件），Make会根据规则推导来运行依赖于这个文件的命令，一般来说，可以和“-n”参数一同使用，来查看这个依赖文件所发生的规则命令。</p>
</dd>
</dl>
<p>另外一个很有意思的用法是结合 <code class="docutils literal notranslate"><span class="pre">-p</span></code> 和 <code class="docutils literal notranslate"><span class="pre">-v</span></code> 来输出makefile被执行时的信息（这个将在后面讲述）。</p>
</section>
<section id="id4">
<h2>make的参数<a class="headerlink" href="#id4" title="永久链接至标题"></a></h2>
<p>下面列举了所有GNU make 3.80版的参数定义。其它版本和产商的make大同小异，不过其它产商的make的具体参数还是请参考各自的产品文档。</p>
<dl class="simple">
<dt><code class="docutils literal notranslate"><span class="pre">-b</span></code>, <code class="docutils literal notranslate"><span class="pre">-m</span></code></dt><dd><p>这两个参数的作用是忽略和其它版本make的兼容性。</p>
</dd>
<dt><code class="docutils literal notranslate"><span class="pre">-B</span></code>, <code class="docutils literal notranslate"><span class="pre">--always-make</span></code></dt><dd><p>认为所有的目标都需要更新（重编译）。</p>
</dd>
<dt><code class="docutils literal notranslate"><span class="pre">-C</span></code> <em>&lt;dir&gt;</em>, <code class="docutils literal notranslate"><span class="pre">--directory</span></code>=<em>&lt;dir&gt;</em></dt><dd><p>指定读取makefile的目录。如果有多个“-C”参数，make的解释是后面的路径以前面的作为相对路径，并以最后的目录作为被指定目录。如：“make -C ~hchen/test -C prog”等价于“make -C ~hchen/test/prog”。</p>
</dd>
<dt><code class="docutils literal notranslate"><span class="pre">-debug</span></code>[=<em>&lt;options&gt;</em>]</dt><dd><p>输出make的调试信息。它有几种不同的级别可供选择，如果没有参数，那就是输出最简单的调试信息。下面是&lt;options&gt;的取值：</p>
<ul class="simple">
<li><p>a: 也就是all，输出所有的调试信息。（会非常的多）</p></li>
<li><p>b: 也就是basic，只输出简单的调试信息。即输出不需要重编译的目标。</p></li>
<li><p>v: 也就是verbose，在b选项的级别之上。输出的信息包括哪个makefile被解析，不需要被重编译的依赖文件（或是依赖目标）等。</p></li>
<li><p>i: 也就是implicit，输出所以的隐含规则。</p></li>
<li><p>j: 也就是jobs，输出执行规则中命令的详细信息，如命令的PID、返回码等。</p></li>
<li><p>m: 也就是makefile，输出make读取makefile，更新makefile，执行makefile的信息。</p></li>
</ul>
</dd>
<dt><code class="docutils literal notranslate"><span class="pre">-d</span></code></dt><dd><p>相当于“–debug=a”。</p>
</dd>
<dt><code class="docutils literal notranslate"><span class="pre">-e</span></code>, <code class="docutils literal notranslate"><span class="pre">--environment-overrides</span></code></dt><dd><p>指明环境变量的值覆盖makefile中定义的变量的值。</p>
</dd>
<dt><code class="docutils literal notranslate"><span class="pre">-f</span></code>=<em>&lt;file&gt;</em>, <code class="docutils literal notranslate"><span class="pre">--file</span></code>=<em>&lt;file&gt;</em>, <code class="docutils literal notranslate"><span class="pre">--makefile</span></code>=<em>&lt;file&gt;</em></dt><dd><p>指定需要执行的makefile。</p>
</dd>
<dt><code class="docutils literal notranslate"><span class="pre">-h</span></code>, <code class="docutils literal notranslate"><span class="pre">--help</span></code></dt><dd><p>显示帮助信息。</p>
</dd>
<dt><code class="docutils literal notranslate"><span class="pre">-i</span></code> , <code class="docutils literal notranslate"><span class="pre">--ignore-errors</span></code></dt><dd><p>在执行时忽略所有的错误。</p>
</dd>
<dt><code class="docutils literal notranslate"><span class="pre">-I</span></code> <em>&lt;dir&gt;</em>, <code class="docutils literal notranslate"><span class="pre">--include-dir</span></code>=<em>&lt;dir&gt;</em></dt><dd><p>指定一个被包含makefile的搜索目标。可以使用多个“-I”参数来指定多个目录。</p>
</dd>
<dt><code class="docutils literal notranslate"><span class="pre">-j</span></code> [<em>&lt;jobsnum&gt;</em>], <code class="docutils literal notranslate"><span class="pre">--jobs</span></code>[=<em>&lt;jobsnum&gt;</em>]</dt><dd><p>指同时运行命令的个数。如果没有这个参数，make运行命令时能运行多少就运行多少。如果有一个以上的“-j”参数，那么仅最后一个“-j”才是有效的。（注意这个参数在MS-DOS中是无用的）</p>
</dd>
<dt><code class="docutils literal notranslate"><span class="pre">-k</span></code>, <code class="docutils literal notranslate"><span class="pre">--keep-going</span></code></dt><dd><p>出错也不停止运行。如果生成一个目标失败了，那么依赖于其上的目标就不会被执行了。</p>
</dd>
<dt><code class="docutils literal notranslate"><span class="pre">-l</span></code> <em>&lt;load&gt;</em>, <code class="docutils literal notranslate"><span class="pre">--load-average</span></code>[=<em>&lt;load&gt;</em>], <code class="docutils literal notranslate"><span class="pre">-max-load</span></code>[=<em>&lt;load&gt;</em>]</dt><dd><p>指定make运行命令的负载。</p>
</dd>
<dt><code class="docutils literal notranslate"><span class="pre">-n</span></code>, <code class="docutils literal notranslate"><span class="pre">--just-print</span></code>, <code class="docutils literal notranslate"><span class="pre">--dry-run</span></code>, <code class="docutils literal notranslate"><span class="pre">--recon</span></code></dt><dd><p>仅输出执行过程中的命令序列，但并不执行。</p>
</dd>
<dt><code class="docutils literal notranslate"><span class="pre">-o</span></code> <em>&lt;file&gt;</em>, <code class="docutils literal notranslate"><span class="pre">--old-file</span></code>=<em>&lt;file&gt;</em>, <code class="docutils literal notranslate"><span class="pre">--assume-old</span></code>=<em>&lt;file&gt;</em></dt><dd><p>不重新生成的指定的&lt;file&gt;，即使这个目标的依赖文件新于它。</p>
</dd>
<dt><code class="docutils literal notranslate"><span class="pre">-p</span></code>, <code class="docutils literal notranslate"><span class="pre">--print-data-base</span></code></dt><dd><p>输出makefile中的所有数据，包括所有的规则和变量。这个参数会让一个简单的makefile都会输出一堆信息。如果你只是想输出信息而不想执行makefile，你可以使用“make -qp”命令。如果你想查看执行makefile前的预设变量和规则，你可以使用 “make –p –f /dev/null”。这个参数输出的信息会包含着你的makefile文件的文件名和行号，所以，用这个参数来调试你的 makefile会是很有用的，特别是当你的环境变量很复杂的时候。</p>
</dd>
<dt><code class="docutils literal notranslate"><span class="pre">-q</span></code>, <code class="docutils literal notranslate"><span class="pre">--question</span></code></dt><dd><p>不运行命令，也不输出。仅仅是检查所指定的目标是否需要更新。如果是0则说明要更新，如果是2则说明有错误发生。</p>
</dd>
<dt><code class="docutils literal notranslate"><span class="pre">-r</span></code>, <code class="docutils literal notranslate"><span class="pre">--no-builtin-rules</span></code></dt><dd><p>禁止make使用任何隐含规则。</p>
</dd>
<dt><code class="docutils literal notranslate"><span class="pre">-R</span></code>, <code class="docutils literal notranslate"><span class="pre">--no-builtin-variabes</span></code></dt><dd><p>禁止make使用任何作用于变量上的隐含规则。</p>
</dd>
<dt><code class="docutils literal notranslate"><span class="pre">-s</span></code>, <code class="docutils literal notranslate"><span class="pre">--silent</span></code>, <code class="docutils literal notranslate"><span class="pre">--quiet</span></code></dt><dd><p>在命令运行时不输出命令的输出。</p>
</dd>
<dt><code class="docutils literal notranslate"><span class="pre">-S</span></code>, <code class="docutils literal notranslate"><span class="pre">--no-keep-going</span></code>, <code class="docutils literal notranslate"><span class="pre">--stop</span></code></dt><dd><p>取消“-k”选项的作用。因为有些时候，make的选项是从环境变量“MAKEFLAGS”中继承下来的。所以你可以在命令行中使用这个参数来让环境变量中的“-k”选项失效。</p>
</dd>
<dt><code class="docutils literal notranslate"><span class="pre">-t</span></code>, <code class="docutils literal notranslate"><span class="pre">--touch</span></code></dt><dd><p>相当于UNIX的touch命令，只是把目标的修改日期变成最新的，也就是阻止生成目标的命令运行。</p>
</dd>
<dt><code class="docutils literal notranslate"><span class="pre">-v</span></code>, <code class="docutils literal notranslate"><span class="pre">--version</span></code></dt><dd><p>输出make程序的版本、版权等关于make的信息。</p>
</dd>
<dt><code class="docutils literal notranslate"><span class="pre">-w</span></code>, <code class="docutils literal notranslate"><span class="pre">--print-directory</span></code></dt><dd><p>输出运行makefile之前和之后的信息。这个参数对于跟踪嵌套式调用make时很有用。</p>
</dd>
<dt><code class="docutils literal notranslate"><span class="pre">--no-print-directory</span></code></dt><dd><p>禁止“-w”选项。</p>
</dd>
<dt><code class="docutils literal notranslate"><span class="pre">-W</span></code> <em>&lt;file&gt;</em>, <code class="docutils literal notranslate"><span class="pre">--what-if</span></code>=<em>&lt;file&gt;</em>, <code class="docutils literal notranslate"><span class="pre">--new-file</span></code>=<em>&lt;file&gt;</em>, <code class="docutils literal notranslate"><span class="pre">--assume-file</span></code>=<em>&lt;file&gt;</em></dt><dd><p>假定目标&lt;file&gt;;需要更新，如果和“-n”选项使用，那么这个参数会输出该目标更新时的运行动作。如果没有“-n”那么就像运行UNIX的“touch”命令一样，使得&lt;file&gt;;的修改时间为当前时间。</p>
</dd>
<dt><code class="docutils literal notranslate"><span class="pre">--warn-undefined-variables</span></code></dt><dd><p>只要make发现有未定义的变量，那么就输出警告信息。</p>
</dd>
</dl>
</section>
</section>
</div>
</div>
<footer><div class="rst-footer-buttons" role="navigation" aria-label="Footer">
<a href="functions.html" class="btn btn-neutral float-left" title="使用函数" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
<a href="implicit_rules.html" class="btn btn-neutral float-right" title="隐含规则" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
</div>
<hr/>
<div role="contentinfo">
<p>&#169; 版权所有 2014-2019, 作者：陈皓；排版：SeisMan.
<span class="lastupdated">最后更新于 2022年5月22日.
</span></p>
</div>
Built with <a href="https://www.sphinx-doc.org/">Sphinx</a> using a
<a href="https://github.com/readthedocs/sphinx_rtd_theme">theme</a>
provided by <a href="https://readthedocs.org">Read the Docs</a>.
</footer>
</div>
</div>
</section>
</div>
<script>
jQuery(function () {
SphinxRtdTheme.Navigation.enable(true);
});
</script>
</body>
</html>

BIN
objects.inv Normal file
View File

Binary file not shown.

139
overview.html Normal file
View File

@ -0,0 +1,139 @@
<!DOCTYPE html>
<html class="writer-html5" lang="zh-CN" >
<head>
<meta charset="utf-8" /><meta name="generator" content="Docutils 0.17.1: http://docutils.sourceforge.net/" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<title>概述 &mdash; 跟我一起写Makefile 1.0 文档</title>
<link rel="stylesheet" href="_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="_static/css/theme.css" type="text/css" />
<!--[if lt IE 9]>
<script src="_static/js/html5shiv.min.js"></script>
<![endif]-->
<script data-url_root="./" id="documentation_options" src="_static/documentation_options.js"></script>
<script src="_static/jquery.js"></script>
<script src="_static/underscore.js"></script>
<script src="_static/doctools.js"></script>
<script src="_static/translations.js"></script>
<script src="_static/js/theme.js"></script>
<link rel="index" title="索引" href="genindex.html" />
<link rel="search" title="搜索" href="search.html" />
<link rel="next" title="makefile介绍" href="introduction.html" />
<link rel="prev" title="跟我一起写Makefile" href="index.html" />
</head>
<body class="wy-body-for-nav">
<div class="wy-grid-for-nav">
<nav data-toggle="wy-nav-shift" class="wy-nav-side">
<div class="wy-side-scroll">
<div class="wy-side-nav-search" >
<a href="index.html" class="icon icon-home"> 跟我一起写Makefile
</a>
<div class="version">
1.0
</div>
<div role="search">
<form id="rtd-search-form" class="wy-form" action="search.html" method="get">
<input type="text" name="q" placeholder="Search docs" />
<input type="hidden" name="check_keywords" value="yes" />
<input type="hidden" name="area" value="default" />
</form>
</div>
</div><div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="Navigation menu">
<p class="caption" role="heading"><span class="caption-text">目录</span></p>
<ul class="current">
<li class="toctree-l1 current"><a class="current reference internal" href="#">概述</a><ul>
<li class="toctree-l2"><a class="reference internal" href="#id2">关于程序的编译和链接</a></li>
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="introduction.html">makefile介绍</a></li>
<li class="toctree-l1"><a class="reference internal" href="rules.html">书写规则</a></li>
<li class="toctree-l1"><a class="reference internal" href="recipes.html">书写命令</a></li>
<li class="toctree-l1"><a class="reference internal" href="variables.html">使用变量</a></li>
<li class="toctree-l1"><a class="reference internal" href="conditionals.html">使用条件判断</a></li>
<li class="toctree-l1"><a class="reference internal" href="functions.html">使用函数</a></li>
<li class="toctree-l1"><a class="reference internal" href="invoke.html">make 的运行</a></li>
<li class="toctree-l1"><a class="reference internal" href="implicit_rules.html">隐含规则</a></li>
<li class="toctree-l1"><a class="reference internal" href="archives.html">使用make更新函数库文件</a></li>
<li class="toctree-l1"><a class="reference internal" href="postscript.html">后序</a></li>
</ul>
</div>
</div>
</nav>
<section data-toggle="wy-nav-shift" class="wy-nav-content-wrap"><nav class="wy-nav-top" aria-label="Mobile navigation menu" >
<i data-toggle="wy-nav-top" class="fa fa-bars"></i>
<a href="index.html">跟我一起写Makefile</a>
</nav>
<div class="wy-nav-content">
<div class="rst-content">
<div role="navigation" aria-label="Page navigation">
<ul class="wy-breadcrumbs">
<li><a href="index.html" class="icon icon-home"></a> &raquo;</li>
<li>概述</li>
<li class="wy-breadcrumbs-aside">
<a href="_sources/overview.rst.txt" rel="nofollow"> View page source</a>
</li>
</ul>
<hr/>
</div>
<div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
<div itemprop="articleBody">
<section id="id1">
<h1>概述<a class="headerlink" href="#id1" title="永久链接至标题"></a></h1>
<p>什么是makefile？或许很多Windows的程序员都不知道这个东西，因为那些Windows的集成开发环境（integrated development environment，IDE）都为你做了这个工作，但我觉得要作一个好的和专业的程序员，makefile还是要懂。这就好像现在有这么多的HTML编辑器，但如果你想成为一个专业人士，你还是要了解HTML的标签的含义。特别在Unix下的软件编译，你就不能不自己写makefile了，会不会写makefile，从一个侧面说明了一个人是否具备完成大型工程的能力。</p>
<p>因为，makefile关系到了整个工程的编译规则。一个工程中的源文件不计其数，并且按类型、功能、模块分别放在若干个目录中，makefile定义了一系列的规则来指定，哪些文件需要先编译，哪些文件需要后编译，哪些文件需要重新编译，甚至于进行更复杂的功能操作，因为makefile就像一个Shell脚本一样，其中也可以执行操作系统的命令。</p>
<p>makefile带来的好处就是——“自动化编译”，一旦写好，只需要一个make命令，整个工程完全自动编译，极大的提高了软件开发的效率。 make是一个命令工具，是一个解释makefile中指令的命令工具，一般来说，大多数的IDE都有这个命令，比如：Delphi的make，Visual C++的nmake，Linux下GNU的make。可见，makefile都成为了一种在工程方面的编译方法。</p>
<p>现在讲述如何写makefile的文章比较少，这是我想写这篇文章的原因。当然，不同产商的make各不相同，也有不同的语法，但其本质都是在 “文件依赖性”上做文章，这里，我仅对GNU的make进行讲述，我的环境是RedHat Linux 8.0，make的版本是3.80。毕竟，这个make是应用最为广泛的，也是用得最多的。而且其还是最遵循于IEEE 1003.2-1992标准的（POSIX.2）。</p>
<p>在这篇文档中，将以C/C++的源码作为基础，所以必然涉及一些关于C/C++的编译的知识。关于这方面的内容，还请各位查看相关的编译器的文档。这里所默认的编译器是UNIX下的GCC和CC。</p>
<section id="id2">
<h2>关于程序的编译和链接<a class="headerlink" href="#id2" title="永久链接至标题"></a></h2>
<p>在此，我想多说关于程序编译的一些规范和方法。一般来说，无论是C还是C++，首先要把源文件编译成中间代码文件，在Windows下也就是 <code class="docutils literal notranslate"><span class="pre">.obj</span></code> 文件，UNIX下是 <code class="docutils literal notranslate"><span class="pre">.o</span></code> 文件，即Object File，这个动作叫做编译（compile）。然后再把大量的Object File合成执行文件，这个动作叫作链接（link）。</p>
<p>编译时，编译器需要的是语法的正确，函数与变量的声明的正确。对于后者，通常是你需要告诉编译器头文件的所在位置（头文件中应该只是声明，而定义应该放在C/C++文件中），只要所有的语法正确，编译器就可以编译出中间目标文件。一般来说，每个源文件都应该对应于一个中间目标文件（ <code class="docutils literal notranslate"><span class="pre">.o</span></code> 文件或
<code class="docutils literal notranslate"><span class="pre">.obj</span></code> 文件）。</p>
<p>链接时，主要是链接函数和全局变量。所以，我们可以使用这些中间目标文件（ <code class="docutils literal notranslate"><span class="pre">.o</span></code> 文件或
<code class="docutils literal notranslate"><span class="pre">.obj</span></code> 文件）来链接我们的应用程序。链接器并不管函数所在的源文件，只管函数的中间目标文件（Object File），在大多数时候，由于源文件太多，编译生成的中间目标文件太多，而在链接时需要明显地指出中间目标文件名，这对于编译很不方便。所以，我们要给中间目标文件打个包，在Windows下这种包叫“库文件”（Library File），也就是 <code class="docutils literal notranslate"><span class="pre">.lib</span></code> 文件，在UNIX下，是Archive File，也就是
<code class="docutils literal notranslate"><span class="pre">.a</span></code> 文件。</p>
<p>总结一下，源文件首先会生成中间目标文件，再由中间目标文件生成执行文件。在编译时，编译器只检测程序语法和函数、变量是否被声明。如果函数未被声明，编译器会给出一个警告，但可以生成Object File。而在链接程序时，链接器会在所有的Object File中找寻函数的实现，如果找不到，那到就会报链接错误码（Linker Error），在VC下，这种错误一般是： <code class="docutils literal notranslate"><span class="pre">Link</span> <span class="pre">2001错误</span></code> ，意思说是说，链接器未能找到函数的实现。你需要指定函数的Object File。</p>
<p>好，言归正传，gnu的make有许多的内容，闲言少叙。</p>
</section>
</section>
</div>
</div>
<footer><div class="rst-footer-buttons" role="navigation" aria-label="Footer">
<a href="index.html" class="btn btn-neutral float-left" title="跟我一起写Makefile" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
<a href="introduction.html" class="btn btn-neutral float-right" title="makefile介绍" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
</div>
<hr/>
<div role="contentinfo">
<p>&#169; 版权所有 2014-2019, 作者：陈皓；排版：SeisMan.
<span class="lastupdated">最后更新于 2022年5月22日.
</span></p>
</div>
Built with <a href="https://www.sphinx-doc.org/">Sphinx</a> using a
<a href="https://github.com/readthedocs/sphinx_rtd_theme">theme</a>
provided by <a href="https://readthedocs.org">Read the Docs</a>.
</footer>
</div>
</div>
</section>
</div>
<script>
jQuery(function () {
SphinxRtdTheme.Navigation.enable(true);
});
</script>
</body>
</html>

142
postscript.html Normal file
View File

@ -0,0 +1,142 @@
<!DOCTYPE html>
<html class="writer-html5" lang="zh-CN" >
<head>
<meta charset="utf-8" /><meta name="generator" content="Docutils 0.17.1: http://docutils.sourceforge.net/" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<title>后序 &mdash; 跟我一起写Makefile 1.0 文档</title>
<link rel="stylesheet" href="_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="_static/css/theme.css" type="text/css" />
<!--[if lt IE 9]>
<script src="_static/js/html5shiv.min.js"></script>
<![endif]-->
<script data-url_root="./" id="documentation_options" src="_static/documentation_options.js"></script>
<script src="_static/jquery.js"></script>
<script src="_static/underscore.js"></script>
<script src="_static/doctools.js"></script>
<script src="_static/translations.js"></script>
<script src="_static/js/theme.js"></script>
<link rel="index" title="索引" href="genindex.html" />
<link rel="search" title="搜索" href="search.html" />
<link rel="prev" title="使用make更新函数库文件" href="archives.html" />
</head>
<body class="wy-body-for-nav">
<div class="wy-grid-for-nav">
<nav data-toggle="wy-nav-shift" class="wy-nav-side">
<div class="wy-side-scroll">
<div class="wy-side-nav-search" >
<a href="index.html" class="icon icon-home"> 跟我一起写Makefile
</a>
<div class="version">
1.0
</div>
<div role="search">
<form id="rtd-search-form" class="wy-form" action="search.html" method="get">
<input type="text" name="q" placeholder="Search docs" />
<input type="hidden" name="check_keywords" value="yes" />
<input type="hidden" name="area" value="default" />
</form>
</div>
</div><div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="Navigation menu">
<p class="caption" role="heading"><span class="caption-text">目录</span></p>
<ul class="current">
<li class="toctree-l1"><a class="reference internal" href="overview.html">概述</a></li>
<li class="toctree-l1"><a class="reference internal" href="introduction.html">makefile介绍</a></li>
<li class="toctree-l1"><a class="reference internal" href="rules.html">书写规则</a></li>
<li class="toctree-l1"><a class="reference internal" href="recipes.html">书写命令</a></li>
<li class="toctree-l1"><a class="reference internal" href="variables.html">使用变量</a></li>
<li class="toctree-l1"><a class="reference internal" href="conditionals.html">使用条件判断</a></li>
<li class="toctree-l1"><a class="reference internal" href="functions.html">使用函数</a></li>
<li class="toctree-l1"><a class="reference internal" href="invoke.html">make 的运行</a></li>
<li class="toctree-l1"><a class="reference internal" href="implicit_rules.html">隐含规则</a></li>
<li class="toctree-l1"><a class="reference internal" href="archives.html">使用make更新函数库文件</a></li>
<li class="toctree-l1 current"><a class="current reference internal" href="#">后序</a></li>
</ul>
</div>
</div>
</nav>
<section data-toggle="wy-nav-shift" class="wy-nav-content-wrap"><nav class="wy-nav-top" aria-label="Mobile navigation menu" >
<i data-toggle="wy-nav-top" class="fa fa-bars"></i>
<a href="index.html">跟我一起写Makefile</a>
</nav>
<div class="wy-nav-content">
<div class="rst-content">
<div role="navigation" aria-label="Page navigation">
<ul class="wy-breadcrumbs">
<li><a href="index.html" class="icon icon-home"></a> &raquo;</li>
<li>后序</li>
<li class="wy-breadcrumbs-aside">
<a href="_sources/postscript.rst.txt" rel="nofollow"> View page source</a>
</li>
</ul>
<hr/>
</div>
<div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
<div itemprop="articleBody">
<section id="id1">
<h1>后序<a class="headerlink" href="#id1" title="永久链接至标题"></a></h1>
<p>终于到写结束语的时候了，以上基本上就是GNU make的Makefile的所有细节了。其它的厂商的make基本上也就是这样的，无论什么样的make，都是以文件的依赖性为基础的，其基本是都是遵循一个标准的。这篇文档中80%的技术细节都适用于任何的make，我猜测“函数”那一章的内容可能不是其它make所支持的，而隐含规则方面，我想不同的make会有不同的实现，我没有精力来查看GNU的make和VC的nmake、BCB的 make
，或是别的UNIX下的make有些什么样的差别，一是时间精力不够，二是因为我基本上都是在Unix下使用make，以前在SCO Unix和 IBM的AIX，现在在Linux、Solaris、HP-UX、AIX和Alpha下使用，Linux和Solaris下更多一点。不过，我可以肯定的是，在Unix下的make，无论是哪种平台，几乎都使用了Richard Stallman开发的make和cc/gcc的编译器，而且，基本上都是 GNU的make（公司里所有的UNIX机器上都被装上了GNU的东西，所以，使用GNU的程序也就多了一些）。GNU的东西还是很不错的，特别是使用得深了以后，越来越觉得GNU的软件的强大，也越来越觉得GNU的在操作系统中（主要是Unix，甚至Windows）“杀伤力”。</p>
<p>对于上述所有的make的细节，我们不但可以利用make这个工具来编译我们的程序，还可以利用make来完成其它的工作，因为规则中的命令可以是任何Shell之下的命令，所以，在Unix下，你不一定只是使用程序语言的编译器，你还可以在Makefile中书写其它的命令，如：tar、 awk、mail、sed、cvs、compress
、ls、rm、yacc、rpm、ftp等等，等等，来完成诸如“程序打包”、“程序备份”、“制作程序安装包”、“提交代码”、“使用程序模板”、“合并文件”等等五花八门的功能，文件操作，文件管理，编程开发设计，或是其它一些异想天开的东西。比如，以前在书写银行交易程序时，由于银行的交易程序基本一样，就见到有人书写了一些交易的通用程序模板，在该模板中把一些网络通讯、数据库操作的、业务操作共性的东西写在一个文件中，在这些文件中用些诸如“&#64;&#64;&#64;N、###N”奇怪字串标注一些位置，然后书写交易时，只需按照一种特定的规则书写特定的处理，最后在make时，使用awk和sed，把模板中的“&#64;&#64;&#64;N、###N”等字串替代成特定的程序，形成C文件，然后再编译。这个动作很像数据库的“扩展C”语言（即在C语言中用“EXEC SQL”的样子执行SQL语句，在用cc/gcc编译之前，需要使用“扩展C”的翻译程序，如cpre，把其翻译成标准C）。如果你在使用make时有一些更为绝妙的方法，请记得告诉我啊。</p>
<p>回头看看整篇文档，不觉记起几年前刚刚开始在Unix下做开发的时候，有人问我会不会写Makefile时，我两眼发直，根本不知道在说什么。一开始看到别人在vi中写完程序后输入“!make”时，还以为是vi的功能，后来才知道有一个Makefile在作怪，于是上网查啊查，那时又不愿意看英文，发现就根本没有中文的文档介绍Makefile，只得看别人写的Makefile，自己瞎碰瞎搞才积累了一点知识，但在很多地方完全是知其然不知所以然。后来开始从事UNIX下产品软件的开发，看到一个400人，近200万行代码的大工程，发现要编译这样一个庞然大物，如果没有Makefile，那会是多么恐怖的一样事啊。于是横下心来，狠命地读了一堆英文文档，才觉得对其掌握了。但发现目前网上对Makefile介绍的文章还是少得那么的可怜，所以想写这样一篇文章，共享给大家，希望能对各位有所帮助。</p>
<p>现在我终于写完了，看了看文件的创建时间，这篇技术文档也写了两个多月了。发现，自己知道是一回事，要写下来，跟别人讲述又是另外一回事，而且，现在越来越没有时间钻研技术细节，所以在写作时，发现在阐述一些细节问题时很难做到严谨和精炼，而且对先讲什么后讲什么不是很清楚，所以，还是参考了一些国外站点上的资料和提纲，以及一些技术书籍的语言风格，才得以完成。整篇文档的提纲是基于GNU
的Makefile技术手册的提纲来书写的，并结合了自己的工作经验，以及自己的学习历程。因为从来没有写过这么长，这么细的文档，所以一定会有很多地方存在表达问题，语言歧义或是错误。因些，我迫切地等待各位给我指正和建议，以及任何的反馈。</p>
<p>最后，还是利用这个后序，介绍一下自己。我目前从事于所有Unix平台下的软件研发，主要是做分布式计算/网格计算方面的系统产品软件，并且我对于下一代的计算机革命——网格计算非常地感兴趣，对于分布式计算、P2P、Web Service、J2EE技术方向也很感兴趣，同时，对于项目实施、团队管理、项目管理也小有心得，希望同样和我战斗在“技术和管理并重”的阵线上的年轻一代，能够和我多多地交流。我的MSN是：
<a class="reference external" href="mailto:haoel&#37;&#52;&#48;hotmail">haoel<span>&#64;</span>hotmail</a>.com（常用），QQ是：753640（不常用）。（注：请勿给我MSN的邮箱发信，由于hotmail的垃圾邮件导致我拒收这个邮箱的所有来信）</p>
<p>我欢迎任何形式的交流，无论是讨论技术还是管理，或是其它海阔天空的东西。除了政治和娱乐新闻我不关心，其它只要积极向上的东西我都欢迎！</p>
<p>最最后，我还想介绍一下make程序的设计开发者。</p>
<p>首当其冲的是：Richard Stallman</p>
<p>开源软件的领袖和先驱，从来没有领过一天工资，从来没有使用过Windows操作系统。对于他的事迹和他的软件以及他的思想，我无需说过多的话，相信大家对这个人并不比我陌生，这是他的主页：<a class="reference external" href="http://www.stallman.org/">http://www.stallman.org/</a> 。这里只贴上一张他的近照：</p>
<p><a class="reference external" href="http://bbs.chinaunix.net/attachments/rms.jpg">http://bbs.chinaunix.net/attachments/rms.jpg</a></p>
<p>第二位是：Roland McGrath</p>
<p>个人主页是：<a class="reference external" href="http://www.frob.com/~roland/">http://www.frob.com/~roland/</a> ，下面是他的一些事迹：</p>
<ol class="arabic simple">
<li><p>合作编写了并维护GNU make。</p></li>
<li><p>和Thomas Bushnell一同编写了GNU Hurd。</p></li>
<li><p>编写并维护着GNU C library。</p></li>
<li><p>合作编写并维护着部分的GNU Emacs。</p></li>
</ol>
<p>在此，向这两位开源项目的斗士致以最真切的敬意。</p>
<p>（全文完）</p>
</section>
</div>
</div>
<footer><div class="rst-footer-buttons" role="navigation" aria-label="Footer">
<a href="archives.html" class="btn btn-neutral float-left" title="使用make更新函数库文件" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
</div>
<hr/>
<div role="contentinfo">
<p>&#169; 版权所有 2014-2019, 作者：陈皓；排版：SeisMan.
<span class="lastupdated">最后更新于 2022年5月22日.
</span></p>
</div>
Built with <a href="https://www.sphinx-doc.org/">Sphinx</a> using a
<a href="https://github.com/readthedocs/sphinx_rtd_theme">theme</a>
provided by <a href="https://readthedocs.org">Read the Docs</a>.
</footer>
</div>
</div>
</section>
</div>
<script>
jQuery(function () {
SphinxRtdTheme.Navigation.enable(true);
});
</script>
</body>
</html>

270
recipes.html Normal file
View File

@ -0,0 +1,270 @@
<!DOCTYPE html>
<html class="writer-html5" lang="zh-CN" >
<head>
<meta charset="utf-8" /><meta name="generator" content="Docutils 0.17.1: http://docutils.sourceforge.net/" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<title>书写命令 &mdash; 跟我一起写Makefile 1.0 文档</title>
<link rel="stylesheet" href="_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="_static/css/theme.css" type="text/css" />
<!--[if lt IE 9]>
<script src="_static/js/html5shiv.min.js"></script>
<![endif]-->
<script data-url_root="./" id="documentation_options" src="_static/documentation_options.js"></script>
<script src="_static/jquery.js"></script>
<script src="_static/underscore.js"></script>
<script src="_static/doctools.js"></script>
<script src="_static/translations.js"></script>
<script src="_static/js/theme.js"></script>
<link rel="index" title="索引" href="genindex.html" />
<link rel="search" title="搜索" href="search.html" />
<link rel="next" title="使用变量" href="variables.html" />
<link rel="prev" title="书写规则" href="rules.html" />
</head>
<body class="wy-body-for-nav">
<div class="wy-grid-for-nav">
<nav data-toggle="wy-nav-shift" class="wy-nav-side">
<div class="wy-side-scroll">
<div class="wy-side-nav-search" >
<a href="index.html" class="icon icon-home"> 跟我一起写Makefile
</a>
<div class="version">
1.0
</div>
<div role="search">
<form id="rtd-search-form" class="wy-form" action="search.html" method="get">
<input type="text" name="q" placeholder="Search docs" />
<input type="hidden" name="check_keywords" value="yes" />
<input type="hidden" name="area" value="default" />
</form>
</div>
</div><div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="Navigation menu">
<p class="caption" role="heading"><span class="caption-text">目录</span></p>
<ul class="current">
<li class="toctree-l1"><a class="reference internal" href="overview.html">概述</a></li>
<li class="toctree-l1"><a class="reference internal" href="introduction.html">makefile介绍</a></li>
<li class="toctree-l1"><a class="reference internal" href="rules.html">书写规则</a></li>
<li class="toctree-l1 current"><a class="current reference internal" href="#">书写命令</a><ul>
<li class="toctree-l2"><a class="reference internal" href="#id2">显示命令</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id3">命令执行</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id4">命令出错</a></li>
<li class="toctree-l2"><a class="reference internal" href="#make">嵌套执行make</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id5">定义命令包</a></li>
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="variables.html">使用变量</a></li>
<li class="toctree-l1"><a class="reference internal" href="conditionals.html">使用条件判断</a></li>
<li class="toctree-l1"><a class="reference internal" href="functions.html">使用函数</a></li>
<li class="toctree-l1"><a class="reference internal" href="invoke.html">make 的运行</a></li>
<li class="toctree-l1"><a class="reference internal" href="implicit_rules.html">隐含规则</a></li>
<li class="toctree-l1"><a class="reference internal" href="archives.html">使用make更新函数库文件</a></li>
<li class="toctree-l1"><a class="reference internal" href="postscript.html">后序</a></li>
</ul>
</div>
</div>
</nav>
<section data-toggle="wy-nav-shift" class="wy-nav-content-wrap"><nav class="wy-nav-top" aria-label="Mobile navigation menu" >
<i data-toggle="wy-nav-top" class="fa fa-bars"></i>
<a href="index.html">跟我一起写Makefile</a>
</nav>
<div class="wy-nav-content">
<div class="rst-content">
<div role="navigation" aria-label="Page navigation">
<ul class="wy-breadcrumbs">
<li><a href="index.html" class="icon icon-home"></a> &raquo;</li>
<li>书写命令</li>
<li class="wy-breadcrumbs-aside">
<a href="_sources/recipes.rst.txt" rel="nofollow"> View page source</a>
</li>
</ul>
<hr/>
</div>
<div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
<div itemprop="articleBody">
<section id="id1">
<h1>书写命令<a class="headerlink" href="#id1" title="永久链接至标题"></a></h1>
<p>每条规则中的命令和操作系统Shell的命令行是一致的。make会一按顺序一条一条的执行命令，每条命令的开头必须以 <code class="docutils literal notranslate"><span class="pre">Tab</span></code> 键开头，除非，命令是紧跟在依赖规则后面的分号后的。在命令行之间中的空格或是空行会被忽略，但是如果该空格或空行是以Tab键开头的，那么make会认为其是一个空命令。</p>
<p>我们在UNIX下可能会使用不同的Shell，但是make的命令默认是被 <code class="docutils literal notranslate"><span class="pre">/bin/sh</span></code> ——UNIX的标准Shell
解释执行的。除非你特别指定一个其它的Shell。Makefile中， <code class="docutils literal notranslate"><span class="pre">#</span></code> 是注释符，很像C/C++中的
<code class="docutils literal notranslate"><span class="pre">//</span></code> ，其后的本行字符都被注释。</p>
<section id="id2">
<h2>显示命令<a class="headerlink" href="#id2" title="永久链接至标题"></a></h2>
<p>通常，make会把其要执行的命令行在命令执行前输出到屏幕上。当我们用 <code class="docutils literal notranslate"><span class="pre">&#64;</span></code> 字符在命令行前，那么，这个命令将不被make显示出来，最具代表性的例子是，我们用这个功能来向屏幕显示一些信息。如:</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="nd">@echo</span> <span class="n">正在编译XXX模块</span><span class="o">......</span>
</pre></div>
</div>
<p>当make执行时，会输出“正在编译XXX模块……”字串，但不会输出命令，如果没有“&#64;”，那么，make将输出:</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">echo</span> <span class="n">正在编译XXX模块</span><span class="o">......</span>
<span class="n">正在编译XXX模块</span><span class="o">......</span>
</pre></div>
</div>
<p>如果make执行时，带入make参数 <code class="docutils literal notranslate"><span class="pre">-n</span></code> 或 <code class="docutils literal notranslate"><span class="pre">--just-print</span></code> ，那么其只是显示命令，但不会执行命令，这个功能很有利于我们调试我们的Makefile，看看我们书写的命令是执行起来是什么样子的或是什么顺序的。</p>
<p>而make参数 <code class="docutils literal notranslate"><span class="pre">-s</span></code> 或 <code class="docutils literal notranslate"><span class="pre">--silent</span></code> 或 <code class="docutils literal notranslate"><span class="pre">--quiet</span></code> 则是全面禁止命令的显示。</p>
</section>
<section id="id3">
<h2>命令执行<a class="headerlink" href="#id3" title="永久链接至标题"></a></h2>
<p>当依赖目标新于目标时，也就是当规则的目标需要被更新时，make会一条一条的执行其后的命令。需要注意的是，如果你要让上一条命令的结果应用在下一条命令时，你应该使用分号分隔这两条命令。比如你的第一条命令是cd命令，你希望第二条命令得在cd之后的基础上运行，那么你就不能把这两条命令写在两行上，而应该把这两条命令写在一行上，用分号分隔。如：</p>
<ul class="simple">
<li><p>示例一：</p></li>
</ul>
<div class="highlight-makefile notranslate"><div class="highlight"><pre><span></span><span class="nf">exec</span><span class="o">:</span>
<span class="nb">cd</span> /home/hchen
<span class="nb">pwd</span>
</pre></div>
</div>
<ul class="simple">
<li><p>示例二：</p></li>
</ul>
<div class="highlight-makefile notranslate"><div class="highlight"><pre><span></span><span class="nf">exec</span><span class="o">:</span>
<span class="nb">cd</span> /home/hchen<span class="p">;</span> <span class="nb">pwd</span>
</pre></div>
</div>
<p>当我们执行 <code class="docutils literal notranslate"><span class="pre">make</span> <span class="pre">exec</span></code> 时，第一个例子中的cd没有作用，pwd会打印出当前的Makefile目录，而第二个例子中，cd就起作用了，pwd会打印出“/home/hchen”。</p>
<p>make一般是使用环境变量SHELL中所定义的系统Shell来执行命令，默认情况下使用UNIX的标准Shell——/bin/sh来执行命令。但在MS-DOS下有点特殊，因为MS-DOS下没有SHELL环境变量，当然你也可以指定。如果你指定了UNIX风格的目录形式，首先，make会在SHELL所指定的路径中找寻命令解释器，如果找不到，其会在当前盘符中的当前目录中寻找，如果再找不到，其会在PATH环境变量中所定义的所有路径中寻找。MS-DOS中，如果你定义的命令解释器没有找到，其会给你的命令解释器加上诸如 <code class="docutils literal notranslate"><span class="pre">.exe</span></code> 、
<code class="docutils literal notranslate"><span class="pre">.com</span></code> 、 <code class="docutils literal notranslate"><span class="pre">.bat</span></code> 、 <code class="docutils literal notranslate"><span class="pre">.sh</span></code> 等后缀。</p>
</section>
<section id="id4">
<h2>命令出错<a class="headerlink" href="#id4" title="永久链接至标题"></a></h2>
<p>每当命令运行完后，make会检测每个命令的返回码，如果命令返回成功，那么make会执行下一条命令，当规则中所有的命令成功返回后，这个规则就算是成功完成了。如果一个规则中的某个命令出错了（命令退出码非零），那么make就会终止执行当前规则，这将有可能终止所有规则的执行。</p>
<p>有些时候，命令的出错并不表示就是错误的。例如mkdir命令，我们一定需要建立一个目录，如果目录不存在，那么mkdir就成功执行，万事大吉，如果目录存在，那么就出错了。我们之所以使用mkdir的意思就是一定要有这样的一个目录，于是我们就不希望mkdir出错而终止规则的运行。</p>
<p>为了做到这一点，忽略命令的出错，我们可以在Makefile的命令行前加一个减号 <code class="docutils literal notranslate"><span class="pre">-</span></code> （在Tab键之后），标记为不管命令出不出错都认为是成功的。如：</p>
<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>clean:
-rm -f *.o
</pre></div>
</div>
<p>还有一个全局的办法是，给make加上 <code class="docutils literal notranslate"><span class="pre">-i</span></code> 或是 <code class="docutils literal notranslate"><span class="pre">--ignore-errors</span></code> 参数，那么，Makefile中所有命令都会忽略错误。而如果一个规则是以 <code class="docutils literal notranslate"><span class="pre">.IGNORE</span></code> 作为目标的，那么这个规则中的所有命令将会忽略错误。这些是不同级别的防止命令出错的方法，你可以根据你的不同喜欢设置。</p>
<p>还有一个要提一下的make的参数的是 <code class="docutils literal notranslate"><span class="pre">-k</span></code> 或是 <code class="docutils literal notranslate"><span class="pre">--keep-going</span></code> ，这个参数的意思是，如果某规则中的命令出错了，那么就终止该规则的执行，但继续执行其它规则。</p>
</section>
<section id="make">
<h2>嵌套执行make<a class="headerlink" href="#make" title="永久链接至标题"></a></h2>
<p>在一些大的工程中，我们会把我们不同模块或是不同功能的源文件放在不同的目录中，我们可以在每个目录中都书写一个该目录的Makefile，这有利于让我们的Makefile变得更加地简洁，而不至于把所有的东西全部写在一个Makefile中，这样会很难维护我们的Makefile，这个技术对于我们模块编译和分段编译有着非常大的好处。</p>
<p>例如，我们有一个子目录叫subdir，这个目录下有个Makefile文件，来指明了这个目录下文件的编译规则。那么我们总控的Makefile可以这样书写：</p>
<div class="highlight-makefile notranslate"><div class="highlight"><pre><span></span><span class="nf">subsystem</span><span class="o">:</span>
<span class="nb">cd</span> subdir <span class="o">&amp;&amp;</span> <span class="k">$(</span>MAKE<span class="k">)</span>
</pre></div>
</div>
<p>其等价于：</p>
<div class="highlight-makefile notranslate"><div class="highlight"><pre><span></span><span class="nf">subsystem</span><span class="o">:</span>
<span class="k">$(</span>MAKE<span class="k">)</span> -C subdir
</pre></div>
</div>
<p>定义$(MAKE)宏变量的意思是，也许我们的make需要一些参数，所以定义成一个变量比较利于维护。这两个例子的意思都是先进入“subdir”目录，然后执行make命令。</p>
<p>我们把这个Makefile叫做“总控Makefile”，总控Makefile的变量可以传递到下级的Makefile中（如果你显示的声明），但是不会覆盖下层的Makefile中所定义的变量，除非指定了 <code class="docutils literal notranslate"><span class="pre">-e</span></code> 参数。</p>
<p>如果你要传递变量到下级Makefile中，那么你可以使用这样的声明:</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">export</span> <span class="o">&lt;</span><span class="n">variable</span> <span class="o">...&gt;</span><span class="p">;</span>
</pre></div>
</div>
<p>如果你不想让某些变量传递到下级Makefile中，那么你可以这样声明:</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">unexport</span> <span class="o">&lt;</span><span class="n">variable</span> <span class="o">...&gt;</span><span class="p">;</span>
</pre></div>
</div>
<p>如：</p>
<p>示例一：</p>
<div class="highlight-makefile notranslate"><div class="highlight"><pre><span></span><span class="k">export </span><span class="nv">variable</span> <span class="o">=</span> value
</pre></div>
</div>
<p>其等价于：</p>
<div class="highlight-makefile notranslate"><div class="highlight"><pre><span></span><span class="nv">variable</span> <span class="o">=</span> value
<span class="k">export</span> <span class="nv">variable</span>
</pre></div>
</div>
<p>其等价于：</p>
<div class="highlight-makefile notranslate"><div class="highlight"><pre><span></span><span class="k">export </span><span class="nv">variable</span> <span class="o">:=</span> value
</pre></div>
</div>
<p>其等价于：</p>
<div class="highlight-makefile notranslate"><div class="highlight"><pre><span></span><span class="nv">variable</span> <span class="o">:=</span> value
<span class="k">export</span> <span class="nv">variable</span>
</pre></div>
</div>
<p>示例二：</p>
<div class="highlight-makefile notranslate"><div class="highlight"><pre><span></span><span class="k">export </span><span class="nv">variable</span> <span class="o">+=</span> value
</pre></div>
</div>
<p>其等价于：</p>
<div class="highlight-makefile notranslate"><div class="highlight"><pre><span></span><span class="nv">variable</span> <span class="o">+=</span> value
<span class="k">export</span> <span class="nv">variable</span>
</pre></div>
</div>
<p>如果你要传递所有的变量，那么，只要一个export就行了。后面什么也不用跟，表示传递所有的变量。</p>
<p>需要注意的是，有两个变量，一个是 <code class="docutils literal notranslate"><span class="pre">SHELL</span></code> ，一个是 <code class="docutils literal notranslate"><span class="pre">MAKEFLAGS</span></code> ，这两个变量不管你是否export，其总是要传递到下层 Makefile中，特别是 <code class="docutils literal notranslate"><span class="pre">MAKEFLAGS</span></code> 变量，其中包含了make的参数信息，如果我们执行“总控Makefile”时有make参数或是在上层 Makefile中定义了这个变量，那么
<code class="docutils literal notranslate"><span class="pre">MAKEFLAGS</span></code> 变量将会是这些参数，并会传递到下层Makefile中，这是一个系统级的环境变量。</p>
<p>但是make命令中的有几个参数并不往下传递，它们是 <code class="docutils literal notranslate"><span class="pre">-C</span></code> , <code class="docutils literal notranslate"><span class="pre">-f</span></code> , <code class="docutils literal notranslate"><span class="pre">-h</span></code>, <code class="docutils literal notranslate"><span class="pre">-o</span></code> 和
<code class="docutils literal notranslate"><span class="pre">-W</span></code> （有关Makefile参数的细节将在后面说明），如果你不想往下层传递参数，那么，你可以这样来：</p>
<div class="highlight-makefile notranslate"><div class="highlight"><pre><span></span><span class="nf">subsystem</span><span class="o">:</span>
<span class="nb">cd</span> subdir <span class="o">&amp;&amp;</span> <span class="k">$(</span>MAKE<span class="k">)</span> <span class="nv">MAKEFLAGS</span><span class="o">=</span>
</pre></div>
</div>
<p>如果你定义了环境变量 <code class="docutils literal notranslate"><span class="pre">MAKEFLAGS</span></code> ，那么你得确信其中的选项是大家都会用到的，如果其中有
<code class="docutils literal notranslate"><span class="pre">-t</span></code> , <code class="docutils literal notranslate"><span class="pre">-n</span></code> 和 <code class="docutils literal notranslate"><span class="pre">-q</span></code> 参数，那么将会有让你意想不到的结果，或许会让你异常地恐慌。</p>
<p>还有一个在“嵌套执行”中比较有用的参数， <code class="docutils literal notranslate"><span class="pre">-w</span></code> 或是 <code class="docutils literal notranslate"><span class="pre">--print-directory</span></code> 会在make的过程中输出一些信息，让你看到目前的工作目录。比如，如果我们的下级make目录是“/home/hchen/gnu/make”，如果我们使用 <code class="docutils literal notranslate"><span class="pre">make</span> <span class="pre">-w</span></code> 来执行，那么当进入该目录时，我们会看到:</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span>make: Entering directory `/home/hchen/gnu/make&#39;.
</pre></div>
</div>
<p>而在完成下层make后离开目录时，我们会看到:</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span>make: Leaving directory `/home/hchen/gnu/make&#39;
</pre></div>
</div>
<p>当你使用 <code class="docutils literal notranslate"><span class="pre">-C</span></code> 参数来指定make下层Makefile时， <code class="docutils literal notranslate"><span class="pre">-w</span></code> 会被自动打开的。如果参数中有
<code class="docutils literal notranslate"><span class="pre">-s</span></code> （ <code class="docutils literal notranslate"><span class="pre">--slient</span></code> ）或是 <code class="docutils literal notranslate"><span class="pre">--no-print-directory</span></code> ，那么， <code class="docutils literal notranslate"><span class="pre">-w</span></code> 总是失效的。</p>
</section>
<section id="id5">
<h2>定义命令包<a class="headerlink" href="#id5" title="永久链接至标题"></a></h2>
<p>如果Makefile中出现一些相同命令序列，那么我们可以为这些相同的命令序列定义一个变量。定义这种命令序列的语法以 <code class="docutils literal notranslate"><span class="pre">define</span></code> 开始，以 <code class="docutils literal notranslate"><span class="pre">endef</span></code> 结束，如:</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span>define run-yacc
yacc $(firstword $^)
mv y.tab.c $@
endef
</pre></div>
</div>
<p>这里，“run-yacc”是这个命令包的名字，其不要和Makefile中的变量重名。在 <code class="docutils literal notranslate"><span class="pre">define</span></code> 和
<code class="docutils literal notranslate"><span class="pre">endef</span></code> 中的两行就是命令序列。这个命令包中的第一个命令是运行Yacc程序，因为Yacc程序总是生成“y.tab.c”的文件，所以第二行的命令就是把这个文件改改名字。还是把这个命令包放到一个示例中来看看吧。</p>
<div class="highlight-makefile notranslate"><div class="highlight"><pre><span></span><span class="nf">foo.c </span><span class="o">:</span> <span class="n">foo</span>.<span class="n">y</span>
<span class="k">$(</span>run-yacc<span class="k">)</span>
</pre></div>
</div>
<p>我们可以看见，要使用这个命令包，我们就好像使用变量一样。在这个命令包的使用中，命令包“run-yacc”中的 <code class="docutils literal notranslate"><span class="pre">$^</span></code> 就是 <code class="docutils literal notranslate"><span class="pre">foo.y</span></code> ， <code class="docutils literal notranslate"><span class="pre">$&#64;</span></code> 就是 <code class="docutils literal notranslate"><span class="pre">foo.c</span></code> （有关这种以 <code class="docutils literal notranslate"><span class="pre">$</span></code>
开头的特殊变量，我们会在后面介绍），make在执行命令包时，命令包中的每个命令会被依次独立执行。</p>
</section>
</section>
</div>
</div>
<footer><div class="rst-footer-buttons" role="navigation" aria-label="Footer">
<a href="rules.html" class="btn btn-neutral float-left" title="书写规则" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
<a href="variables.html" class="btn btn-neutral float-right" title="使用变量" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
</div>
<hr/>
<div role="contentinfo">
<p>&#169; 版权所有 2014-2019, 作者：陈皓；排版：SeisMan.
<span class="lastupdated">最后更新于 2022年5月22日.
</span></p>
</div>
Built with <a href="https://www.sphinx-doc.org/">Sphinx</a> using a
<a href="https://github.com/readthedocs/sphinx_rtd_theme">theme</a>
provided by <a href="https://readthedocs.org">Read the Docs</a>.
</footer>
</div>
</div>
</section>
</div>
<script>
jQuery(function () {
SphinxRtdTheme.Navigation.enable(true);
});
</script>
</body>
</html>

431
rules.html Normal file
View File

@ -0,0 +1,431 @@
<!DOCTYPE html>
<html class="writer-html5" lang="zh-CN" >
<head>
<meta charset="utf-8" /><meta name="generator" content="Docutils 0.17.1: http://docutils.sourceforge.net/" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<title>书写规则 &mdash; 跟我一起写Makefile 1.0 文档</title>
<link rel="stylesheet" href="_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="_static/css/theme.css" type="text/css" />
<!--[if lt IE 9]>
<script src="_static/js/html5shiv.min.js"></script>
<![endif]-->
<script data-url_root="./" id="documentation_options" src="_static/documentation_options.js"></script>
<script src="_static/jquery.js"></script>
<script src="_static/underscore.js"></script>
<script src="_static/doctools.js"></script>
<script src="_static/translations.js"></script>
<script src="_static/js/theme.js"></script>
<link rel="index" title="索引" href="genindex.html" />
<link rel="search" title="搜索" href="search.html" />
<link rel="next" title="书写命令" href="recipes.html" />
<link rel="prev" title="makefile介绍" href="introduction.html" />
</head>
<body class="wy-body-for-nav">
<div class="wy-grid-for-nav">
<nav data-toggle="wy-nav-shift" class="wy-nav-side">
<div class="wy-side-scroll">
<div class="wy-side-nav-search" >
<a href="index.html" class="icon icon-home"> 跟我一起写Makefile
</a>
<div class="version">
1.0
</div>
<div role="search">
<form id="rtd-search-form" class="wy-form" action="search.html" method="get">
<input type="text" name="q" placeholder="Search docs" />
<input type="hidden" name="check_keywords" value="yes" />
<input type="hidden" name="area" value="default" />
</form>
</div>
</div><div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="Navigation menu">
<p class="caption" role="heading"><span class="caption-text">目录</span></p>
<ul class="current">
<li class="toctree-l1"><a class="reference internal" href="overview.html">概述</a></li>
<li class="toctree-l1"><a class="reference internal" href="introduction.html">makefile介绍</a></li>
<li class="toctree-l1 current"><a class="current reference internal" href="#">书写规则</a><ul>
<li class="toctree-l2"><a class="reference internal" href="#id2">规则举例</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id3">规则的语法</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id4">在规则中使用通配符</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id5">文件搜寻</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id6">伪目标</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id7">多目标</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id8">静态模式</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id9">自动生成依赖性</a></li>
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="recipes.html">书写命令</a></li>
<li class="toctree-l1"><a class="reference internal" href="variables.html">使用变量</a></li>
<li class="toctree-l1"><a class="reference internal" href="conditionals.html">使用条件判断</a></li>
<li class="toctree-l1"><a class="reference internal" href="functions.html">使用函数</a></li>
<li class="toctree-l1"><a class="reference internal" href="invoke.html">make 的运行</a></li>
<li class="toctree-l1"><a class="reference internal" href="implicit_rules.html">隐含规则</a></li>
<li class="toctree-l1"><a class="reference internal" href="archives.html">使用make更新函数库文件</a></li>
<li class="toctree-l1"><a class="reference internal" href="postscript.html">后序</a></li>
</ul>
</div>
</div>
</nav>
<section data-toggle="wy-nav-shift" class="wy-nav-content-wrap"><nav class="wy-nav-top" aria-label="Mobile navigation menu" >
<i data-toggle="wy-nav-top" class="fa fa-bars"></i>
<a href="index.html">跟我一起写Makefile</a>
</nav>
<div class="wy-nav-content">
<div class="rst-content">
<div role="navigation" aria-label="Page navigation">
<ul class="wy-breadcrumbs">
<li><a href="index.html" class="icon icon-home"></a> &raquo;</li>
<li>书写规则</li>
<li class="wy-breadcrumbs-aside">
<a href="_sources/rules.rst.txt" rel="nofollow"> View page source</a>
</li>
</ul>
<hr/>
</div>
<div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
<div itemprop="articleBody">
<section id="id1">
<h1>书写规则<a class="headerlink" href="#id1" title="永久链接至标题"></a></h1>
<p>规则包含两个部分，一个是依赖关系，一个是生成目标的方法。</p>
<p>在Makefile中，规则的顺序是很重要的，因为，Makefile中只应该有一个最终目标，其它的目标都是被这个目标所连带出来的，所以一定要让make知道你的最终目标是什么。一般来说，定义在Makefile中的目标可能会有很多，但是第一条规则中的目标将被确立为最终的目标。如果第一条规则中的目标有很多个，那么，第一个目标会成为最终的目标。make所完成的也就是这个目标。</p>
<p>好了，还是让我们来看一看如何书写规则。</p>
<section id="id2">
<h2>规则举例<a class="headerlink" href="#id2" title="永久链接至标题"></a></h2>
<div class="highlight-makefile notranslate"><div class="highlight"><pre><span></span><span class="nf">foo.o</span><span class="o">:</span> <span class="n">foo</span>.<span class="n">c</span> <span class="n">defs</span>.<span class="n">h</span> <span class="c"># foo模块</span>
cc -c -g foo.c
</pre></div>
</div>
<p>看到这个例子，各位应该不是很陌生了，前面也已说过， <code class="docutils literal notranslate"><span class="pre">foo.o</span></code> 是我们的目标， <code class="docutils literal notranslate"><span class="pre">foo.c</span></code> 和
<code class="docutils literal notranslate"><span class="pre">defs.h</span></code> 是目标所依赖的源文件，而只有一个命令 <code class="docutils literal notranslate"><span class="pre">cc</span> <span class="pre">-c</span> <span class="pre">-g</span> <span class="pre">foo.c</span></code> （以Tab键开头）。这个规则告诉我们两件事：</p>
<ol class="arabic simple">
<li><p>文件的依赖关系， <code class="docutils literal notranslate"><span class="pre">foo.o</span></code> 依赖于 <code class="docutils literal notranslate"><span class="pre">foo.c</span></code> 和 <code class="docutils literal notranslate"><span class="pre">defs.h</span></code> 的文件，如果 <code class="docutils literal notranslate"><span class="pre">foo.c</span></code>
和 <code class="docutils literal notranslate"><span class="pre">defs.h</span></code> 的文件日期要比 <code class="docutils literal notranslate"><span class="pre">foo.o</span></code> 文件日期要新，或是 <code class="docutils literal notranslate"><span class="pre">foo.o</span></code> 不存在，那么依赖关系发生。</p></li>
<li><p>生成或更新 <code class="docutils literal notranslate"><span class="pre">foo.o</span></code> 文件，就是那个cc命令。它说明了如何生成 <code class="docutils literal notranslate"><span class="pre">foo.o</span></code> 这个文件。（当然，foo.c文件include了defs.h文件）</p></li>
</ol>
</section>
<section id="id3">
<h2>规则的语法<a class="headerlink" href="#id3" title="永久链接至标题"></a></h2>
<div class="highlight-makefile notranslate"><div class="highlight"><pre><span></span><span class="nf">targets </span><span class="o">:</span> <span class="n">prerequisites</span>
<span class="nb">command</span>
...
</pre></div>
</div>
<p>或是这样：</p>
<div class="highlight-makefile notranslate"><div class="highlight"><pre><span></span><span class="nf">targets </span><span class="o">:</span> <span class="n">prerequisites</span> ; <span class="n">command</span>
<span class="nb">command</span>
...
</pre></div>
</div>
<p>targets是文件名，以空格分开，可以使用通配符。一般来说，我们的目标基本上是一个文件，但也有可能是多个文件。</p>
<p>command是命令行，如果其不与“target:prerequisites”在一行，那么，必须以 <code class="docutils literal notranslate"><span class="pre">Tab</span></code> 键开头，如果和prerequisites在一行，那么可以用分号做为分隔。（见上）</p>
<p>prerequisites也就是目标所依赖的文件（或依赖目标）。如果其中的某个文件要比目标文件要新，那么，目标就被认为是“过时的”，被认为是需要重生成的。这个在前面已经讲过了。</p>
<p>如果命令太长，你可以使用反斜杠（ <code class="docutils literal notranslate"><span class="pre">\</span></code> ）作为换行符。make对一行上有多少个字符没有限制。规则告诉make两件事，文件的依赖关系和如何生成目标文件。</p>
<p>一般来说，make会以UNIX的标准Shell，也就是 <code class="docutils literal notranslate"><span class="pre">/bin/sh</span></code> 来执行命令。</p>
</section>
<section id="id4">
<h2>在规则中使用通配符<a class="headerlink" href="#id4" title="永久链接至标题"></a></h2>
<p>如果我们想定义一系列比较类似的文件，我们很自然地就想起使用通配符。make支持三个通配符：
<code class="docutils literal notranslate"><span class="pre">*</span></code> ， <code class="docutils literal notranslate"><span class="pre">?</span></code> 和 <code class="docutils literal notranslate"><span class="pre">~</span></code> 。这是和Unix的B-Shell是相同的。</p>
<p>波浪号（ <code class="docutils literal notranslate"><span class="pre">~</span></code> ）字符在文件名中也有比较特殊的用途。如果是 <code class="docutils literal notranslate"><span class="pre">~/test</span></code> ，这就表示当前用户的 <code class="docutils literal notranslate"><span class="pre">$HOME</span></code> 目录下的test目录。而 <code class="docutils literal notranslate"><span class="pre">~hchen/test</span></code> 则表示用户hchen的宿主目录下的test
目录。（这些都是Unix下的小知识了，make也支持）而在Windows或是 MS-DOS下，用户没有宿主目录，那么波浪号所指的目录则根据环境变量“HOME”而定。</p>
<p>通配符代替了你一系列的文件，如 <code class="docutils literal notranslate"><span class="pre">*.c</span></code> 表示所有后缀为c的文件。一个需要我们注意的是，如果我们的文件名中有通配符，如： <code class="docutils literal notranslate"><span class="pre">*</span></code> ，那么可以用转义字符 <code class="docutils literal notranslate"><span class="pre">\</span></code> ，如 <code class="docutils literal notranslate"><span class="pre">\*</span></code> 来表示真实的 <code class="docutils literal notranslate"><span class="pre">*</span></code>
字符，而不是任意长度的字符串。</p>
<p>好吧，还是先来看几个例子吧：</p>
<div class="highlight-makefile notranslate"><div class="highlight"><pre><span></span><span class="nf">clean</span><span class="o">:</span>
rm -f *.o
</pre></div>
</div>
<p>其实在这个clean:后面可以加上你想做的一些事情，如果你想看到在编译完后看看main.c的源代码，你可以在加上cat这个命令，例子如下：</p>
<div class="highlight-makefile notranslate"><div class="highlight"><pre><span></span><span class="nf">clean</span><span class="o">:</span>
cat main.c
rm -f *.o
</pre></div>
</div>
<p>其结果你试一下就知道的。 上面这个例子我不不多说了，这是操作系统Shell所支持的通配符。这是在命令中的通配符。</p>
<div class="highlight-makefile notranslate"><div class="highlight"><pre><span></span><span class="nf">print</span><span class="o">:</span> *.<span class="n">c</span>
lpr -p <span class="nv">$?</span>
touch print
</pre></div>
</div>
<p>上面这个例子说明了通配符也可以在我们的规则中，目标print依赖于所有的 <code class="docutils literal notranslate"><span class="pre">.c</span></code> 文件。其中的
<code class="docutils literal notranslate"><span class="pre">$?</span></code> 是一个自动化变量，我会在后面给你讲述。</p>
<div class="highlight-makefile notranslate"><div class="highlight"><pre><span></span><span class="nv">objects</span> <span class="o">=</span> *.o
</pre></div>
</div>
<p>上面这个例子，表示了通配符同样可以用在变量中。并不是说 <code class="docutils literal notranslate"><span class="pre">*.o</span></code> 会展开，不！objects的值就是
<code class="docutils literal notranslate"><span class="pre">*.o</span></code> 。Makefile中的变量其实就是C/C++中的宏。如果你要让通配符在变量中展开，也就是让objects的值是所有 <code class="docutils literal notranslate"><span class="pre">.o</span></code> 的文件名的集合，那么，你可以这样：</p>
<div class="highlight-makefile notranslate"><div class="highlight"><pre><span></span><span class="nv">objects</span> <span class="o">:=</span> <span class="k">$(</span>wildcard *.o<span class="k">)</span>
</pre></div>
</div>
<p>另给一个变量使用通配符的例子：</p>
<ol class="arabic">
<li><p>列出一确定文件夹中的所有 <code class="docutils literal notranslate"><span class="pre">.c</span></code> 文件。</p>
<div class="highlight-makefile notranslate"><div class="highlight"><pre><span></span><span class="nv">objects</span> <span class="o">:=</span> <span class="k">$(</span>wildcard *.c<span class="k">)</span>
</pre></div>
</div>
</li>
<li><p>列出(1)中所有文件对应的 <code class="docutils literal notranslate"><span class="pre">.o</span></code> 文件，在（3）中我们可以看到它是由make自动编译出的:</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span>$(patsubst %.c,%.o,$(wildcard *.c))
</pre></div>
</div>
</li>
<li><p>由(1)(2)两步，可写出编译并链接所有 <code class="docutils literal notranslate"><span class="pre">.c</span></code> 和 <code class="docutils literal notranslate"><span class="pre">.o</span></code> 文件</p>
<div class="highlight-makefile notranslate"><div class="highlight"><pre><span></span><span class="nv">objects</span> <span class="o">:=</span> <span class="k">$(</span>patsubst %.c,%.o,<span class="k">$(</span>wildcard *.c<span class="k">))</span>
<span class="nf">foo </span><span class="o">:</span> <span class="k">$(</span><span class="nv">objects</span><span class="k">)</span>
cc -o foo <span class="k">$(</span>objects<span class="k">)</span>
</pre></div>
</div>
</li>
</ol>
<p>这种用法由关键字“wildcard”，“patsubst”指出，关于Makefile的关键字，我们将在后面讨论。</p>
</section>
<section id="id5">
<h2>文件搜寻<a class="headerlink" href="#id5" title="永久链接至标题"></a></h2>
<p>在一些大的工程中，有大量的源文件，我们通常的做法是把这许多的源文件分类，并存放在不同的目录中。所以，当make需要去找寻文件的依赖关系时，你可以在文件前加上路径，但最好的方法是把一个路径告诉make，让make在自动去找。</p>
<p>Makefile文件中的特殊变量 <code class="docutils literal notranslate"><span class="pre">VPATH</span></code> 就是完成这个功能的，如果没有指明这个变量，make只会在当前的目录中去找寻依赖文件和目标文件。如果定义了这个变量，那么，make就会在当前目录找不到的情况下，到所指定的目录中去找寻文件了。</p>
<div class="highlight-makefile notranslate"><div class="highlight"><pre><span></span><span class="nv">VPATH</span> <span class="o">=</span> src:../headers
</pre></div>
</div>
<p>上面的定义指定两个目录，“src”和“../headers”，make会按照这个顺序进行搜索。目录由“冒号”分隔。（当然，当前目录永远是最高优先搜索的地方）</p>
<p>另一个设置文件搜索路径的方法是使用make的“vpath”关键字（注意，它是全小写的），这不是变量，这是一个make的关键字，这和上面提到的那个VPATH变量很类似，但是它更为灵活。它可以指定不同的文件在不同的搜索目录中。这是一个很灵活的功能。它的使用方法有三种：</p>
<dl class="simple">
<dt><code class="docutils literal notranslate"><span class="pre">vpath</span> <span class="pre">&lt;pattern&gt;</span> <span class="pre">&lt;directories&gt;</span></code></dt><dd><p>为符合模式&lt;pattern&gt;的文件指定搜索目录&lt;directories&gt;。</p>
</dd>
<dt><code class="docutils literal notranslate"><span class="pre">vpath</span> <span class="pre">&lt;pattern&gt;</span></code></dt><dd><p>清除符合模式&lt;pattern&gt;的文件的搜索目录。</p>
</dd>
<dt><code class="docutils literal notranslate"><span class="pre">vpath</span></code></dt><dd><p>清除所有已被设置好了的文件搜索目录。</p>
</dd>
</dl>
<p>vpath使用方法中的&lt;pattern&gt;需要包含 <code class="docutils literal notranslate"><span class="pre">%</span></code> 字符。 <code class="docutils literal notranslate"><span class="pre">%</span></code> 的意思是匹配零或若干字符，（需引用
<code class="docutils literal notranslate"><span class="pre">%</span></code> ，使用 <code class="docutils literal notranslate"><span class="pre">\</span></code> ）例如， <code class="docutils literal notranslate"><span class="pre">%.h</span></code> 表示所有以 <code class="docutils literal notranslate"><span class="pre">.h</span></code> 结尾的文件。&lt;pattern&gt;指定了要搜索的文件集，而&lt;directories&gt;则指定了&lt; pattern&gt;的文件集的搜索的目录。例如：</p>
<div class="highlight-makefile notranslate"><div class="highlight"><pre><span></span><span class="cp">vpath %.h ../headers</span>
</pre></div>
</div>
<p>该语句表示，要求make在“../headers”目录下搜索所有以 <code class="docutils literal notranslate"><span class="pre">.h</span></code> 结尾的文件。（如果某文件在当前目录没有找到的话）</p>
<p>我们可以连续地使用vpath语句，以指定不同搜索策略。如果连续的vpath语句中出现了相同的&lt;pattern&gt;
，或是被重复了的&lt;pattern&gt;，那么，make会按照vpath语句的先后顺序来执行搜索。如：</p>
<div class="highlight-makefile notranslate"><div class="highlight"><pre><span></span><span class="cp">vpath %.c foo</span>
<span class="cp">vpath % blish</span>
<span class="cp">vpath %.c bar</span>
</pre></div>
</div>
<p>其表示 <code class="docutils literal notranslate"><span class="pre">.c</span></code> 结尾的文件，先在“foo”目录，然后是“blish”，最后是“bar”目录。</p>
<div class="highlight-makefile notranslate"><div class="highlight"><pre><span></span><span class="cp">vpath %.c foo:bar</span>
<span class="cp">vpath % blish</span>
</pre></div>
</div>
<p>而上面的语句则表示 <code class="docutils literal notranslate"><span class="pre">.c</span></code> 结尾的文件，先在“foo”目录，然后是“bar”目录，最后才是“blish”目录。</p>
</section>
<section id="id6">
<h2>伪目标<a class="headerlink" href="#id6" title="永久链接至标题"></a></h2>
<p>最早先的一个例子中，我们提到过一个“clean”的目标，这是一个“伪目标”，</p>
<div class="highlight-makefile notranslate"><div class="highlight"><pre><span></span><span class="nf">clean</span><span class="o">:</span>
rm *.o temp
</pre></div>
</div>
<p>正像我们前面例子中的“clean”一样，既然我们生成了许多文件编译文件，我们也应该提供一个清除它们的“目标”以备完整地重编译而用。 （以“make clean”来使用该目标）</p>
<p>因为，我们并不生成“clean”这个文件。“伪目标”并不是一个文件，只是一个标签，由于“伪目标”不是文件，所以make无法生成它的依赖关系和决定它是否要执行。我们只有通过显式地指明这个“目标”才能让其生效。当然，“伪目标”的取名不能和文件名重名，不然其就失去了“伪目标”的意义了。</p>
<p>当然，为了避免和文件重名的这种情况，我们可以使用一个特殊的标记“.PHONY”来显式地指明一个目标是“伪目标”，向make说明，不管是否有这个文件，这个目标就是“伪目标”。</p>
<div class="highlight-makefile notranslate"><div class="highlight"><pre><span></span><span class="nf">.PHONY </span><span class="o">:</span> <span class="n">clean</span>
</pre></div>
</div>
<p>只要有这个声明，不管是否有“clean”文件，要运行“clean”这个目标，只有“make clean”这样。于是整个过程可以这样写：</p>
<div class="highlight-makefile notranslate"><div class="highlight"><pre><span></span><span class="nf">.PHONY </span><span class="o">:</span> <span class="n">clean</span>
<span class="nf">clean </span><span class="o">:</span>
rm *.o temp
</pre></div>
</div>
<p>伪目标一般没有依赖的文件。但是，我们也可以为伪目标指定所依赖的文件。伪目标同样可以作为“默认目标”，只要将其放在第一个。一个示例就是，如果你的Makefile需要一口气生成若干个可执行文件，但你只想简单地敲一个make完事，并且，所有的目标文件都写在一个Makefile中，那么你可以使用“伪目标”这个特性：</p>
<div class="highlight-makefile notranslate"><div class="highlight"><pre><span></span><span class="nf">all </span><span class="o">:</span> <span class="n">prog</span>1 <span class="n">prog</span>2 <span class="n">prog</span>3
<span class="nf">.PHONY </span><span class="o">:</span> <span class="n">all</span>
<span class="nf">prog1 </span><span class="o">:</span> <span class="n">prog</span>1.<span class="n">o</span> <span class="n">utils</span>.<span class="n">o</span>
cc -o prog1 prog1.o utils.o
<span class="nf">prog2 </span><span class="o">:</span> <span class="n">prog</span>2.<span class="n">o</span>
cc -o prog2 prog2.o
<span class="nf">prog3 </span><span class="o">:</span> <span class="n">prog</span>3.<span class="n">o</span> <span class="n">sort</span>.<span class="n">o</span> <span class="n">utils</span>.<span class="n">o</span>
cc -o prog3 prog3.o sort.o utils.o
</pre></div>
</div>
<p>我们知道，Makefile中的第一个目标会被作为其默认目标。我们声明了一个“all”的伪目标，其依赖于其它三个目标。由于默认目标的特性是，总是被执行的，但由于“all”又是一个伪目标，伪目标只是一个标签不会生成文件，所以不会有“all”文件产生。于是，其它三个目标的规则总是会被决议。也就达到了我们一口气生成多个目标的目的。 <code class="docutils literal notranslate"><span class="pre">.PHONY</span> <span class="pre">:</span> <span class="pre">all</span></code> 声明了“all”这个目标为“伪目标”。（注：这里的显式“.PHONY : all” 不写的话一般情况也可以正确的执行，这样make可通过隐式规则推导出， “all” 是一个伪目标，执行make不会生成“all”文件，而执行后面的多个目标。建议：显式写出是一个好习惯。）</p>
<p>随便提一句，从上面的例子我们可以看出，目标也可以成为依赖。所以，伪目标同样也可成为依赖。看下面的例子：</p>
<div class="highlight-makefile notranslate"><div class="highlight"><pre><span></span><span class="nf">.PHONY </span><span class="o">:</span> <span class="n">cleanall</span> <span class="n">cleanobj</span> <span class="n">cleandiff</span>
<span class="nf">cleanall </span><span class="o">:</span> <span class="n">cleanobj</span> <span class="n">cleandiff</span>
rm program
<span class="nf">cleanobj </span><span class="o">:</span>
rm *.o
<span class="nf">cleandiff </span><span class="o">:</span>
rm *.diff
</pre></div>
</div>
<p>“make cleanall”将清除所有要被清除的文件。“cleanobj”和“cleandiff”这两个伪目标有点像“子程序”的意思。我们可以输入“make cleanall”和“make cleanobj”和“make cleandiff”命令来达到清除不同种类文件的目的。</p>
</section>
<section id="id7">
<h2>多目标<a class="headerlink" href="#id7" title="永久链接至标题"></a></h2>
<p>Makefile的规则中的目标可以不止一个，其支持多目标，有可能我们的多个目标同时依赖于一个文件，并且其生成的命令大体类似。于是我们就能把其合并起来。当然，多个目标的生成规则的执行命令不是同一个，这可能会给我们带来麻烦，不过好在我们可以使用一个自动化变量 <code class="docutils literal notranslate"><span class="pre">$&#64;</span></code> （关于自动化变量，将在后面讲述），这个变量表示着目前规则中所有的目标的集合，这样说可能很抽象，还是看一个例子吧。</p>
<div class="highlight-makefile notranslate"><div class="highlight"><pre><span></span><span class="nf">bigoutput littleoutput </span><span class="o">:</span> <span class="n">text</span>.<span class="n">g</span>
generate text.g -<span class="k">$(</span>subst output,,<span class="nv">$@</span><span class="k">)</span> &gt; <span class="nv">$@</span>
</pre></div>
</div>
<p>上述规则等价于：</p>
<div class="highlight-makefile notranslate"><div class="highlight"><pre><span></span><span class="nf">bigoutput </span><span class="o">:</span> <span class="n">text</span>.<span class="n">g</span>
generate text.g -big &gt; bigoutput
<span class="nf">littleoutput </span><span class="o">:</span> <span class="n">text</span>.<span class="n">g</span>
generate text.g -little &gt; littleoutput
</pre></div>
</div>
<p>其中， <code class="docutils literal notranslate"><span class="pre">-$(subst</span> <span class="pre">output,,$&#64;)</span></code> 中的 <code class="docutils literal notranslate"><span class="pre">$</span></code> 表示执行一个Makefile的函数，函数名为subst，后面的为参数。关于函数，将在后面讲述。这里的这个函数是替换字符串的意思， <code class="docutils literal notranslate"><span class="pre">$&#64;</span></code> 表示目标的集合，就像一个数组， <code class="docutils literal notranslate"><span class="pre">$&#64;</span></code> 依次取出目标，并执于命令。</p>
</section>
<section id="id8">
<h2>静态模式<a class="headerlink" href="#id8" title="永久链接至标题"></a></h2>
<p>静态模式可以更加容易地定义多目标的规则，可以让我们的规则变得更加的有弹性和灵活。我们还是先来看一下语法：</p>
<div class="highlight-makefile notranslate"><div class="highlight"><pre><span></span><span class="nf">&lt;targets ...&gt; </span><span class="o">:</span> &lt;<span class="n">target</span>-<span class="n">pattern</span>&gt; : &lt;<span class="n">prereq</span>-<span class="n">patterns</span> ...&gt;
&lt;commands&gt;
...
</pre></div>
</div>
<p>targets定义了一系列的目标文件，可以有通配符。是目标的一个集合。</p>
<p>target-pattern是指明了targets的模式，也就是的目标集模式。</p>
<p>prereq-patterns是目标的依赖模式，它对target-pattern形成的模式再进行一次依赖目标的定义。</p>
<p>这样描述这三个东西，可能还是没有说清楚，还是举个例子来说明一下吧。如果我们的&lt;target-pattern&gt;定义成 <code class="docutils literal notranslate"><span class="pre">%.o</span></code> ，意思是我们的&lt;target&gt;;集合中都是以 <code class="docutils literal notranslate"><span class="pre">.o</span></code> 结尾的，而如果我们的&lt;prereq-patterns&gt;定义成 <code class="docutils literal notranslate"><span class="pre">%.c</span></code> ，意思是对&lt;target-pattern&gt;所形成的目标集进行二次定义，其计算方法是，取&lt;target-pattern&gt;模式中的 <code class="docutils literal notranslate"><span class="pre">%</span></code> （也就是去掉了 <code class="docutils literal notranslate"><span class="pre">.o</span></code> 这个结尾），并为其加上 <code class="docutils literal notranslate"><span class="pre">.c</span></code> 这个结尾，形成的新集合。</p>
<p>所以，我们的“目标模式”或是“依赖模式”中都应该有 <code class="docutils literal notranslate"><span class="pre">%</span></code> 这个字符，如果你的文件名中有 <code class="docutils literal notranslate"><span class="pre">%</span></code> 那么你可以使用反斜杠 <code class="docutils literal notranslate"><span class="pre">\</span></code> 进行转义，来标明真实的 <code class="docutils literal notranslate"><span class="pre">%</span></code> 字符。</p>
<p>看一个例子：</p>
<div class="highlight-makefile notranslate"><div class="highlight"><pre><span></span><span class="nv">objects</span> <span class="o">=</span> foo.o bar.o
<span class="nf">all</span><span class="o">:</span> <span class="k">$(</span><span class="nv">objects</span><span class="k">)</span>
<span class="nf">$(objects)</span><span class="o">:</span> %.<span class="n">o</span>: %.<span class="n">c</span>
<span class="k">$(</span>CC<span class="k">)</span> -c <span class="k">$(</span>CFLAGS<span class="k">)</span> $&lt; -o <span class="nv">$@</span>
</pre></div>
</div>
<p>上面的例子中，指明了我们的目标从$object中获取， <code class="docutils literal notranslate"><span class="pre">%.o</span></code> 表明要所有以 <code class="docutils literal notranslate"><span class="pre">.o</span></code> 结尾的目标，也就是 <code class="docutils literal notranslate"><span class="pre">foo.o</span> <span class="pre">bar.o</span></code> ，也就是变量 <code class="docutils literal notranslate"><span class="pre">$object</span></code> 集合的模式，而依赖模式 <code class="docutils literal notranslate"><span class="pre">%.c</span></code> 则取模式
<code class="docutils literal notranslate"><span class="pre">%.o</span></code> 的 <code class="docutils literal notranslate"><span class="pre">%</span></code> ，也就是 <code class="docutils literal notranslate"><span class="pre">foo</span> <span class="pre">bar</span></code> ，并为其加下 <code class="docutils literal notranslate"><span class="pre">.c</span></code> 的后缀，于是，我们的依赖目标就是 <code class="docutils literal notranslate"><span class="pre">foo.c</span> <span class="pre">bar.c</span></code> 。而命令中的 <code class="docutils literal notranslate"><span class="pre">$&lt;</span></code> 和 <code class="docutils literal notranslate"><span class="pre">$&#64;</span></code> 则是自动化变量， <code class="docutils literal notranslate"><span class="pre">$&lt;</span></code> 表示第一个依赖文件，
<code class="docutils literal notranslate"><span class="pre">$&#64;</span></code> 表示目标集（也就是“foo.o bar.o”）。于是，上面的规则展开后等价于下面的规则：</p>
<div class="highlight-makefile notranslate"><div class="highlight"><pre><span></span><span class="nf">foo.o </span><span class="o">:</span> <span class="n">foo</span>.<span class="n">c</span>
<span class="k">$(</span>CC<span class="k">)</span> -c <span class="k">$(</span>CFLAGS<span class="k">)</span> foo.c -o foo.o
<span class="nf">bar.o </span><span class="o">:</span> <span class="n">bar</span>.<span class="n">c</span>
<span class="k">$(</span>CC<span class="k">)</span> -c <span class="k">$(</span>CFLAGS<span class="k">)</span> bar.c -o bar.o
</pre></div>
</div>
<p>试想，如果我们的 <code class="docutils literal notranslate"><span class="pre">%.o</span></code> 有几百个，那么我们只要用这种很简单的“静态模式规则”就可以写完一堆规则，实在是太有效率了。“静态模式规则”的用法很灵活，如果用得好，那会是一个很强大的功能。再看一个例子：</p>
<div class="highlight-makefile notranslate"><div class="highlight"><pre><span></span><span class="nv">files</span> <span class="o">=</span> foo.elc bar.o lose.o
<span class="nf">$(filter %.o,$(files))</span><span class="o">:</span> %.<span class="n">o</span>: %.<span class="n">c</span>
<span class="k">$(</span>CC<span class="k">)</span> -c <span class="k">$(</span>CFLAGS<span class="k">)</span> $&lt; -o <span class="nv">$@</span>
<span class="nf">$(filter %.elc,$(files))</span><span class="o">:</span> %.<span class="n">elc</span>: %.<span class="n">el</span>
emacs -f batch-byte-compile $&lt;
</pre></div>
</div>
<p>$(filter %.o,$(files))表示调用Makefile的filter函数，过滤“$files”集，只要其中模式为“%.o”的内容。其它的内容，我就不用多说了吧。这个例子展示了Makefile中更大的弹性。</p>
</section>
<section id="id9">
<h2>自动生成依赖性<a class="headerlink" href="#id9" title="永久链接至标题"></a></h2>
<p>在Makefile中，我们的依赖关系可能会需要包含一系列的头文件，比如，如果我们的main.c中有一句
<code class="docutils literal notranslate"><span class="pre">#include</span> <span class="pre">&quot;defs.h&quot;</span></code> ，那么我们的依赖关系应该是：</p>
<div class="highlight-makefile notranslate"><div class="highlight"><pre><span></span><span class="nf">main.o </span><span class="o">:</span> <span class="n">main</span>.<span class="n">c</span> <span class="n">defs</span>.<span class="n">h</span>
</pre></div>
</div>
<p>但是，如果是一个比较大型的工程，你必需清楚哪些C文件包含了哪些头文件，并且，你在加入或删除头文件时，也需要小心地修改Makefile，这是一个很没有维护性的工作。为了避免这种繁重而又容易出错的事情，我们可以使用C/C++编译的一个功能。大多数的C/C++编译器都支持一个“-M”的选项，即自动找寻源文件中包含的头文件，并生成一个依赖关系。例如，如果我们执行下面的命令:</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">cc</span> <span class="o">-</span><span class="n">M</span> <span class="n">main</span><span class="o">.</span><span class="n">c</span>
</pre></div>
</div>
<p>其输出是：</p>
<div class="highlight-makefile notranslate"><div class="highlight"><pre><span></span><span class="nf">main.o </span><span class="o">:</span> <span class="n">main</span>.<span class="n">c</span> <span class="n">defs</span>.<span class="n">h</span>
</pre></div>
</div>
<p>于是由编译器自动生成的依赖关系，这样一来，你就不必再手动书写若干文件的依赖关系，而由编译器自动生成了。需要提醒一句的是，如果你使用GNU的C/C++编译器，你得用 <code class="docutils literal notranslate"><span class="pre">-MM</span></code> 参数，不然， <code class="docutils literal notranslate"><span class="pre">-M</span></code>
参数会把一些标准库的头文件也包含进来。</p>
<p>gcc -M main.c的输出是:</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">main</span><span class="o">.</span><span class="n">o</span><span class="p">:</span> <span class="n">main</span><span class="o">.</span><span class="n">c</span> <span class="n">defs</span><span class="o">.</span><span class="n">h</span> <span class="o">/</span><span class="n">usr</span><span class="o">/</span><span class="n">include</span><span class="o">/</span><span class="n">stdio</span><span class="o">.</span><span class="n">h</span> <span class="o">/</span><span class="n">usr</span><span class="o">/</span><span class="n">include</span><span class="o">/</span><span class="n">features</span><span class="o">.</span><span class="n">h</span> \
<span class="o">/</span><span class="n">usr</span><span class="o">/</span><span class="n">include</span><span class="o">/</span><span class="n">sys</span><span class="o">/</span><span class="n">cdefs</span><span class="o">.</span><span class="n">h</span> <span class="o">/</span><span class="n">usr</span><span class="o">/</span><span class="n">include</span><span class="o">/</span><span class="n">gnu</span><span class="o">/</span><span class="n">stubs</span><span class="o">.</span><span class="n">h</span> \
<span class="o">/</span><span class="n">usr</span><span class="o">/</span><span class="n">lib</span><span class="o">/</span><span class="n">gcc</span><span class="o">-</span><span class="n">lib</span><span class="o">/</span><span class="n">i486</span><span class="o">-</span><span class="n">suse</span><span class="o">-</span><span class="n">linux</span><span class="o">/</span><span class="mf">2.95.3</span><span class="o">/</span><span class="n">include</span><span class="o">/</span><span class="n">stddef</span><span class="o">.</span><span class="n">h</span> \
<span class="o">/</span><span class="n">usr</span><span class="o">/</span><span class="n">include</span><span class="o">/</span><span class="n">bits</span><span class="o">/</span><span class="n">types</span><span class="o">.</span><span class="n">h</span> <span class="o">/</span><span class="n">usr</span><span class="o">/</span><span class="n">include</span><span class="o">/</span><span class="n">bits</span><span class="o">/</span><span class="n">pthreadtypes</span><span class="o">.</span><span class="n">h</span> \
<span class="o">/</span><span class="n">usr</span><span class="o">/</span><span class="n">include</span><span class="o">/</span><span class="n">bits</span><span class="o">/</span><span class="n">sched</span><span class="o">.</span><span class="n">h</span> <span class="o">/</span><span class="n">usr</span><span class="o">/</span><span class="n">include</span><span class="o">/</span><span class="n">libio</span><span class="o">.</span><span class="n">h</span> \
<span class="o">/</span><span class="n">usr</span><span class="o">/</span><span class="n">include</span><span class="o">/</span><span class="n">_G_config</span><span class="o">.</span><span class="n">h</span> <span class="o">/</span><span class="n">usr</span><span class="o">/</span><span class="n">include</span><span class="o">/</span><span class="n">wchar</span><span class="o">.</span><span class="n">h</span> \
<span class="o">/</span><span class="n">usr</span><span class="o">/</span><span class="n">include</span><span class="o">/</span><span class="n">bits</span><span class="o">/</span><span class="n">wchar</span><span class="o">.</span><span class="n">h</span> <span class="o">/</span><span class="n">usr</span><span class="o">/</span><span class="n">include</span><span class="o">/</span><span class="n">gconv</span><span class="o">.</span><span class="n">h</span> \
<span class="o">/</span><span class="n">usr</span><span class="o">/</span><span class="n">lib</span><span class="o">/</span><span class="n">gcc</span><span class="o">-</span><span class="n">lib</span><span class="o">/</span><span class="n">i486</span><span class="o">-</span><span class="n">suse</span><span class="o">-</span><span class="n">linux</span><span class="o">/</span><span class="mf">2.95.3</span><span class="o">/</span><span class="n">include</span><span class="o">/</span><span class="n">stdarg</span><span class="o">.</span><span class="n">h</span> \
<span class="o">/</span><span class="n">usr</span><span class="o">/</span><span class="n">include</span><span class="o">/</span><span class="n">bits</span><span class="o">/</span><span class="n">stdio_lim</span><span class="o">.</span><span class="n">h</span>
</pre></div>
</div>
<p>gcc -MM main.c的输出则是:</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">main</span><span class="o">.</span><span class="n">o</span><span class="p">:</span> <span class="n">main</span><span class="o">.</span><span class="n">c</span> <span class="n">defs</span><span class="o">.</span><span class="n">h</span>
</pre></div>
</div>
<p>那么，编译器的这个功能如何与我们的Makefile联系在一起呢。因为这样一来，我们的Makefile也要根据这些源文件重新生成，让 Makefile自已依赖于源文件？这个功能并不现实，不过我们可以有其它手段来迂回地实现这一功能。GNU组织建议把编译器为每一个源文件的自动生成的依赖关系放到一个文件中，为每一个 <code class="docutils literal notranslate"><span class="pre">name.c</span></code> 的文件都生成一个 <code class="docutils literal notranslate"><span class="pre">name.d</span></code> 的Makefile文件， <code class="docutils literal notranslate"><span class="pre">.d</span></code> 文件中就存放对应
<code class="docutils literal notranslate"><span class="pre">.c</span></code> 文件的依赖关系。</p>
<p>于是，我们可以写出 <code class="docutils literal notranslate"><span class="pre">.c</span></code> 文件和 <code class="docutils literal notranslate"><span class="pre">.d</span></code> 文件的依赖关系，并让make自动更新或生成 <code class="docutils literal notranslate"><span class="pre">.d</span></code>
文件，并把其包含在我们的主Makefile中，这样，我们就可以自动化地生成每个文件的依赖关系了。</p>
<p>这里，我们给出了一个模式规则来产生 <code class="docutils literal notranslate"><span class="pre">.d</span></code> 文件：</p>
<div class="highlight-makefile notranslate"><div class="highlight"><pre><span></span><span class="nf">%.d</span><span class="o">:</span> %.<span class="n">c</span>
@set -e<span class="p">;</span> rm -f <span class="nv">$@</span><span class="p">;</span> <span class="se">\</span>
<span class="k">$(</span>CC<span class="k">)</span> -M <span class="k">$(</span>CPPFLAGS<span class="k">)</span> $&lt; &gt; <span class="nv">$@</span>.<span class="nv">$$$$</span><span class="p">;</span> <span class="se">\</span>
sed <span class="s1">&#39;s,\($*\)\.o[ :]*,\1.o $@ : ,g&#39;</span> &lt; <span class="nv">$@</span>.<span class="nv">$$$$</span> &gt; <span class="nv">$@</span><span class="p">;</span> <span class="se">\</span>
rm -f <span class="nv">$@</span>.<span class="nv">$$$$</span>
</pre></div>
</div>
<p>这个规则的意思是，所有的 <code class="docutils literal notranslate"><span class="pre">.d</span></code> 文件依赖于 <code class="docutils literal notranslate"><span class="pre">.c</span></code> 文件， <code class="docutils literal notranslate"><span class="pre">rm</span> <span class="pre">-f</span> <span class="pre">$&#64;</span></code> 的意思是删除所有的目标，也就是 <code class="docutils literal notranslate"><span class="pre">.d</span></code> 文件，第二行的意思是，为每个依赖文件 <code class="docutils literal notranslate"><span class="pre">$&lt;</span></code> ，也就是 <code class="docutils literal notranslate"><span class="pre">.c</span></code> 文件生成依赖文件， <code class="docutils literal notranslate"><span class="pre">$&#64;</span></code> 表示模式 <code class="docutils literal notranslate"><span class="pre">%.d</span></code> 文件，如果有一个C文件是name.c，那么 <code class="docutils literal notranslate"><span class="pre">%</span></code> 就是
<code class="docutils literal notranslate"><span class="pre">name</span></code> ， <code class="docutils literal notranslate"><span class="pre">$$$$</span></code> 意为一个随机编号，第二行生成的文件有可能是“name.d.12345”，第三行使用sed命令做了一个替换，关于sed命令的用法请参看相关的使用文档。第四行就是删除临时文件。</p>
<p>总而言之，这个模式要做的事就是在编译器生成的依赖关系中加入 <code class="docutils literal notranslate"><span class="pre">.d</span></code> 文件的依赖，即把依赖关系：</p>
<div class="highlight-makefile notranslate"><div class="highlight"><pre><span></span><span class="nf">main.o </span><span class="o">:</span> <span class="n">main</span>.<span class="n">c</span> <span class="n">defs</span>.<span class="n">h</span>
</pre></div>
</div>
<p>转成：</p>
<div class="highlight-makefile notranslate"><div class="highlight"><pre><span></span><span class="nf">main.o main.d </span><span class="o">:</span> <span class="n">main</span>.<span class="n">c</span> <span class="n">defs</span>.<span class="n">h</span>
</pre></div>
</div>
<p>于是，我们的 <code class="docutils literal notranslate"><span class="pre">.d</span></code> 文件也会自动更新了，并会自动生成了，当然，你还可以在这个 <code class="docutils literal notranslate"><span class="pre">.d</span></code> 文件中加入的不只是依赖关系，包括生成的命令也可一并加入，让每个 <code class="docutils literal notranslate"><span class="pre">.d</span></code> 文件都包含一个完赖的规则。一旦我们完成这个工作，接下来，我们就要把这些自动生成的规则放进我们的主Makefile中。我们可以使用Makefile的“include”命令，来引入别的Makefile文件（前面讲过），例如：</p>
<div class="highlight-makefile notranslate"><div class="highlight"><pre><span></span><span class="nv">sources</span> <span class="o">=</span> foo.c bar.c
<span class="cp">include $(sources:.c=.d)</span>
</pre></div>
</div>
<p>上述语句中的 <code class="docutils literal notranslate"><span class="pre">$(sources:.c=.d)</span></code> 中的 <code class="docutils literal notranslate"><span class="pre">.c=.d</span></code> 的意思是做一个替换，把变量
<code class="docutils literal notranslate"><span class="pre">$(sources)</span></code> 所有 <code class="docutils literal notranslate"><span class="pre">.c</span></code> 的字串都替换成 <code class="docutils literal notranslate"><span class="pre">.d</span></code> ，关于这个“替换”的内容，在后面我会有更为详细的讲述。当然，你得注意次序，因为include是按次序来载入文件，最先载入的 <code class="docutils literal notranslate"><span class="pre">.d</span></code> 文件中的目标会成为默认目标。</p>
</section>
</section>
</div>
</div>
<footer><div class="rst-footer-buttons" role="navigation" aria-label="Footer">
<a href="introduction.html" class="btn btn-neutral float-left" title="makefile介绍" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
<a href="recipes.html" class="btn btn-neutral float-right" title="书写命令" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
</div>
<hr/>
<div role="contentinfo">
<p>&#169; 版权所有 2014-2019, 作者：陈皓；排版：SeisMan.
<span class="lastupdated">最后更新于 2022年5月22日.
</span></p>
</div>
Built with <a href="https://www.sphinx-doc.org/">Sphinx</a> using a
<a href="https://github.com/readthedocs/sphinx_rtd_theme">theme</a>
provided by <a href="https://readthedocs.org">Read the Docs</a>.
</footer>
</div>
</div>
</section>
</div>
<script>
jQuery(function () {
SphinxRtdTheme.Navigation.enable(true);
});
</script>
</body>
</html>

131
search.html Normal file
View File

@ -0,0 +1,131 @@
<!DOCTYPE html>
<html class="writer-html5" lang="zh-CN" >
<head>
<meta charset="utf-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<title>搜索 &mdash; 跟我一起写Makefile 1.0 文档</title>
<link rel="stylesheet" href="_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="_static/css/theme.css" type="text/css" />
<!--[if lt IE 9]>
<script src="_static/js/html5shiv.min.js"></script>
<![endif]-->
<script data-url_root="./" id="documentation_options" src="_static/documentation_options.js"></script>
<script src="_static/jquery.js"></script>
<script src="_static/underscore.js"></script>
<script src="_static/doctools.js"></script>
<script src="_static/translations.js"></script>
<script src="_static/js/theme.js"></script>
<script src="_static/searchtools.js"></script>
<script src="_static/language_data.js"></script>
<link rel="index" title="索引" href="genindex.html" />
<link rel="search" title="搜索" href="#" />
</head>
<body class="wy-body-for-nav">
<div class="wy-grid-for-nav">
<nav data-toggle="wy-nav-shift" class="wy-nav-side">
<div class="wy-side-scroll">
<div class="wy-side-nav-search" >
<a href="index.html" class="icon icon-home"> 跟我一起写Makefile
</a>
<div class="version">
1.0
</div>
<div role="search">
<form id="rtd-search-form" class="wy-form" action="#" method="get">
<input type="text" name="q" placeholder="Search docs" />
<input type="hidden" name="check_keywords" value="yes" />
<input type="hidden" name="area" value="default" />
</form>
</div>
</div><div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="Navigation menu">
<p class="caption" role="heading"><span class="caption-text">目录</span></p>
<ul>
<li class="toctree-l1"><a class="reference internal" href="overview.html">概述</a></li>
<li class="toctree-l1"><a class="reference internal" href="introduction.html">makefile介绍</a></li>
<li class="toctree-l1"><a class="reference internal" href="rules.html">书写规则</a></li>
<li class="toctree-l1"><a class="reference internal" href="recipes.html">书写命令</a></li>
<li class="toctree-l1"><a class="reference internal" href="variables.html">使用变量</a></li>
<li class="toctree-l1"><a class="reference internal" href="conditionals.html">使用条件判断</a></li>
<li class="toctree-l1"><a class="reference internal" href="functions.html">使用函数</a></li>
<li class="toctree-l1"><a class="reference internal" href="invoke.html">make 的运行</a></li>
<li class="toctree-l1"><a class="reference internal" href="implicit_rules.html">隐含规则</a></li>
<li class="toctree-l1"><a class="reference internal" href="archives.html">使用make更新函数库文件</a></li>
<li class="toctree-l1"><a class="reference internal" href="postscript.html">后序</a></li>
</ul>
</div>
</div>
</nav>
<section data-toggle="wy-nav-shift" class="wy-nav-content-wrap"><nav class="wy-nav-top" aria-label="Mobile navigation menu" >
<i data-toggle="wy-nav-top" class="fa fa-bars"></i>
<a href="index.html">跟我一起写Makefile</a>
</nav>
<div class="wy-nav-content">
<div class="rst-content">
<div role="navigation" aria-label="Page navigation">
<ul class="wy-breadcrumbs">
<li><a href="index.html" class="icon icon-home"></a> &raquo;</li>
<li>搜索</li>
<li class="wy-breadcrumbs-aside">
</li>
</ul>
<hr/>
</div>
<div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
<div itemprop="articleBody">
<noscript>
<div id="fallback" class="admonition warning">
<p class="last">
Please activate JavaScript to enable the search functionality.
</p>
</div>
</noscript>
<div id="search-results">
</div>
</div>
</div>
<footer>
<hr/>
<div role="contentinfo">
<p>&#169; 版权所有 2014-2019, 作者：陈皓；排版：SeisMan.
<span class="lastupdated">最后更新于 2022年5月22日.
</span></p>
</div>
Built with <a href="https://www.sphinx-doc.org/">Sphinx</a> using a
<a href="https://github.com/readthedocs/sphinx_rtd_theme">theme</a>
provided by <a href="https://readthedocs.org">Read the Docs</a>.
</footer>
</div>
</div>
</section>
</div>
<script>
jQuery(function () {
SphinxRtdTheme.Navigation.enable(true);
});
</script>
<script>
jQuery(function() { Search.loadIndex("searchindex.js"); });
</script>
<script id="searchindexloader"></script>
</body>
</html>

1
searchindex.js Normal file
View File

File diff suppressed because one or more lines are too long

447
variables.html Normal file
View File

@ -0,0 +1,447 @@
<!DOCTYPE html>
<html class="writer-html5" lang="zh-CN" >
<head>
<meta charset="utf-8" /><meta name="generator" content="Docutils 0.17.1: http://docutils.sourceforge.net/" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<title>使用变量 &mdash; 跟我一起写Makefile 1.0 文档</title>
<link rel="stylesheet" href="_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="_static/css/theme.css" type="text/css" />
<!--[if lt IE 9]>
<script src="_static/js/html5shiv.min.js"></script>
<![endif]-->
<script data-url_root="./" id="documentation_options" src="_static/documentation_options.js"></script>
<script src="_static/jquery.js"></script>
<script src="_static/underscore.js"></script>
<script src="_static/doctools.js"></script>
<script src="_static/translations.js"></script>
<script src="_static/js/theme.js"></script>
<link rel="index" title="索引" href="genindex.html" />
<link rel="search" title="搜索" href="search.html" />
<link rel="next" title="使用条件判断" href="conditionals.html" />
<link rel="prev" title="书写命令" href="recipes.html" />
</head>
<body class="wy-body-for-nav">
<div class="wy-grid-for-nav">
<nav data-toggle="wy-nav-shift" class="wy-nav-side">
<div class="wy-side-scroll">
<div class="wy-side-nav-search" >
<a href="index.html" class="icon icon-home"> 跟我一起写Makefile
</a>
<div class="version">
1.0
</div>
<div role="search">
<form id="rtd-search-form" class="wy-form" action="search.html" method="get">
<input type="text" name="q" placeholder="Search docs" />
<input type="hidden" name="check_keywords" value="yes" />
<input type="hidden" name="area" value="default" />
</form>
</div>
</div><div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="Navigation menu">
<p class="caption" role="heading"><span class="caption-text">目录</span></p>
<ul class="current">
<li class="toctree-l1"><a class="reference internal" href="overview.html">概述</a></li>
<li class="toctree-l1"><a class="reference internal" href="introduction.html">makefile介绍</a></li>
<li class="toctree-l1"><a class="reference internal" href="rules.html">书写规则</a></li>
<li class="toctree-l1"><a class="reference internal" href="recipes.html">书写命令</a></li>
<li class="toctree-l1 current"><a class="current reference internal" href="#">使用变量</a><ul>
<li class="toctree-l2"><a class="reference internal" href="#id2">变量的基础</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id3">变量中的变量</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id4">变量高级用法</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id5">追加变量值</a></li>
<li class="toctree-l2"><a class="reference internal" href="#override">override 指示符</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id6">多行变量</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id7">环境变量</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id8">目标变量</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id9">模式变量</a></li>
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="conditionals.html">使用条件判断</a></li>
<li class="toctree-l1"><a class="reference internal" href="functions.html">使用函数</a></li>
<li class="toctree-l1"><a class="reference internal" href="invoke.html">make 的运行</a></li>
<li class="toctree-l1"><a class="reference internal" href="implicit_rules.html">隐含规则</a></li>
<li class="toctree-l1"><a class="reference internal" href="archives.html">使用make更新函数库文件</a></li>
<li class="toctree-l1"><a class="reference internal" href="postscript.html">后序</a></li>
</ul>
</div>
</div>
</nav>
<section data-toggle="wy-nav-shift" class="wy-nav-content-wrap"><nav class="wy-nav-top" aria-label="Mobile navigation menu" >
<i data-toggle="wy-nav-top" class="fa fa-bars"></i>
<a href="index.html">跟我一起写Makefile</a>
</nav>
<div class="wy-nav-content">
<div class="rst-content">
<div role="navigation" aria-label="Page navigation">
<ul class="wy-breadcrumbs">
<li><a href="index.html" class="icon icon-home"></a> &raquo;</li>
<li>使用变量</li>
<li class="wy-breadcrumbs-aside">
<a href="_sources/variables.rst.txt" rel="nofollow"> View page source</a>
</li>
</ul>
<hr/>
</div>
<div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
<div itemprop="articleBody">
<section id="id1">
<h1>使用变量<a class="headerlink" href="#id1" title="永久链接至标题"></a></h1>
<p>在Makefile中的定义的变量，就像是C/C++语言中的宏一样，他代表了一个文本字串，在Makefile中执行的时候其会自动原模原样地展开在所使用的地方。其与C/C++所不同的是，你可以在Makefile中改变其值。在Makefile中，变量可以使用在“目标”，“依赖目标”， “命令”或是Makefile的其它部分中。</p>
<p>变量的命名字可以包含字符、数字，下划线（可以是数字开头），但不应该含有 <code class="docutils literal notranslate"><span class="pre">:</span></code> 、 <code class="docutils literal notranslate"><span class="pre">#</span></code> 、
<code class="docutils literal notranslate"><span class="pre">=</span></code> 或是空字符（空格、回车等）。变量是大小写敏感的，“foo”、“Foo”和“FOO”是三个不同的变量名。传统的Makefile的变量名是全大写的命名方式，但我推荐使用大小写搭配的变量名，如：MakeFlags。这样可以避免和系统的变量冲突，而发生意外的事情。</p>
<p>有一些变量是很奇怪字串，如 <code class="docutils literal notranslate"><span class="pre">$&lt;</span></code> 、 <code class="docutils literal notranslate"><span class="pre">$&#64;</span></code> 等，这些是自动化变量，我会在后面介绍。</p>
<section id="id2">
<h2>变量的基础<a class="headerlink" href="#id2" title="永久链接至标题"></a></h2>
<p>变量在声明时需要给予初值，而在使用时，需要给在变量名前加上 <code class="docutils literal notranslate"><span class="pre">$</span></code> 符号，但最好用小括号
<code class="docutils literal notranslate"><span class="pre">()</span></code> 或是大括号 <code class="docutils literal notranslate"><span class="pre">{}</span></code> 把变量给包括起来。如果你要使用真实的 <code class="docutils literal notranslate"><span class="pre">$</span></code> 字符，那么你需要用
<code class="docutils literal notranslate"><span class="pre">$$</span></code> 来表示。</p>
<p>变量可以使用在许多地方，如规则中的“目标”、“依赖”、“命令”以及新的变量中。先看一个例子：</p>
<div class="highlight-makefile notranslate"><div class="highlight"><pre><span></span><span class="nv">objects</span> <span class="o">=</span> program.o foo.o utils.o
<span class="nf">program </span><span class="o">:</span> <span class="k">$(</span><span class="nv">objects</span><span class="k">)</span>
cc -o program <span class="k">$(</span>objects<span class="k">)</span>
<span class="nf">$(objects) </span><span class="o">:</span> <span class="n">defs</span>.<span class="n">h</span>
</pre></div>
</div>
<p>变量会在使用它的地方精确地展开，就像C/C++中的宏一样，例如：</p>
<div class="highlight-makefile notranslate"><div class="highlight"><pre><span></span><span class="nv">foo</span> <span class="o">=</span> c
<span class="nf">prog.o </span><span class="o">:</span> <span class="n">prog</span>.<span class="k">$(</span><span class="nv">foo</span><span class="k">)</span>
<span class="k">$(</span>foo<span class="k">)$(</span>foo<span class="k">)</span> -<span class="k">$(</span>foo<span class="k">)</span> prog.<span class="k">$(</span>foo<span class="k">)</span>
</pre></div>
</div>
<p>展开后得到：</p>
<div class="highlight-makefile notranslate"><div class="highlight"><pre><span></span><span class="nf">prog.o </span><span class="o">:</span> <span class="n">prog</span>.<span class="n">c</span>
cc -c prog.c
</pre></div>
</div>
<p>当然，千万不要在你的Makefile中这样干，这里只是举个例子来表明Makefile中的变量在使用处展开的真实样子。可见其就是一个“替代”的原理。</p>
<p>另外，给变量加上括号完全是为了更加安全地使用这个变量，在上面的例子中，如果你不想给变量加上括号，那也可以，但我还是强烈建议你给变量加上括号。</p>
</section>
<section id="id3">
<h2>变量中的变量<a class="headerlink" href="#id3" title="永久链接至标题"></a></h2>
<p>在定义变量的值时，我们可以使用其它变量来构造变量的值，在Makefile中有两种方式来在用变量定义变量的值。</p>
<p>先看第一种方式，也就是简单的使用 <code class="docutils literal notranslate"><span class="pre">=</span></code> 号，在 <code class="docutils literal notranslate"><span class="pre">=</span></code> 左侧是变量，右侧是变量的值，右侧变量的值可以定义在文件的任何一处，也就是说，右侧中的变量不一定非要是已定义好的值，其也可以使用后面定义的值。如：</p>
<div class="highlight-makefile notranslate"><div class="highlight"><pre><span></span><span class="nv">foo</span> <span class="o">=</span> <span class="k">$(</span>bar<span class="k">)</span>
<span class="nv">bar</span> <span class="o">=</span> <span class="k">$(</span>ugh<span class="k">)</span>
<span class="nv">ugh</span> <span class="o">=</span> Huh?
<span class="nf">all</span><span class="o">:</span>
<span class="nb">echo</span> <span class="k">$(</span>foo<span class="k">)</span>
</pre></div>
</div>
<p>我们执行“make all”将会打出变量 <code class="docutils literal notranslate"><span class="pre">$(foo)</span></code> 的值是 <code class="docutils literal notranslate"><span class="pre">Huh?</span></code> （ <code class="docutils literal notranslate"><span class="pre">$(foo)</span></code> 的值是
<code class="docutils literal notranslate"><span class="pre">$(bar)</span></code> ， <code class="docutils literal notranslate"><span class="pre">$(bar)</span></code> 的值是 <code class="docutils literal notranslate"><span class="pre">$(ugh)</span></code> ， <code class="docutils literal notranslate"><span class="pre">$(ugh)</span></code> 的值是 <code class="docutils literal notranslate"><span class="pre">Huh?</span></code> ）可见，变量是可以使用后面的变量来定义的。</p>
<p>这个功能有好的地方，也有不好的地方，好的地方是，我们可以把变量的真实值推到后面来定义，如：</p>
<div class="highlight-makefile notranslate"><div class="highlight"><pre><span></span><span class="nv">CFLAGS</span> <span class="o">=</span> <span class="k">$(</span>include_dirs<span class="k">)</span> -O
<span class="nv">include_dirs</span> <span class="o">=</span> -Ifoo -Ibar
</pre></div>
</div>
<p>当 <code class="docutils literal notranslate"><span class="pre">CFLAGS</span></code> 在命令中被展开时，会是 <code class="docutils literal notranslate"><span class="pre">-Ifoo</span> <span class="pre">-Ibar</span> <span class="pre">-O</span></code> 。但这种形式也有不好的地方，那就是递归定义，如：</p>
<div class="highlight-makefile notranslate"><div class="highlight"><pre><span></span><span class="nv">CFLAGS</span> <span class="o">=</span> <span class="k">$(</span>CFLAGS<span class="k">)</span> -O
</pre></div>
</div>
<p>或：</p>
<div class="highlight-makefile notranslate"><div class="highlight"><pre><span></span><span class="nv">A</span> <span class="o">=</span> <span class="k">$(</span>B<span class="k">)</span>
<span class="nv">B</span> <span class="o">=</span> <span class="k">$(</span>A<span class="k">)</span>
</pre></div>
</div>
<p>这会让make陷入无限的变量展开过程中去，当然，我们的make是有能力检测这样的定义，并会报错。还有就是如果在变量中使用函数，那么，这种方式会让我们的make运行时非常慢，更糟糕的是，他会使用得两个make的函数“wildcard”和“shell”发生不可预知的错误。因为你不会知道这两个函数会被调用多少次。</p>
<p>为了避免上面的这种方法，我们可以使用make中的另一种用变量来定义变量的方法。这种方法使用的是 <code class="docutils literal notranslate"><span class="pre">:=</span></code> 操作符，如：</p>
<div class="highlight-makefile notranslate"><div class="highlight"><pre><span></span><span class="nv">x</span> <span class="o">:=</span> foo
<span class="nv">y</span> <span class="o">:=</span> <span class="k">$(</span>x<span class="k">)</span> bar
<span class="nv">x</span> <span class="o">:=</span> later
</pre></div>
</div>
<p>其等价于：</p>
<div class="highlight-makefile notranslate"><div class="highlight"><pre><span></span><span class="nv">y</span> <span class="o">:=</span> foo bar
<span class="nv">x</span> <span class="o">:=</span> later
</pre></div>
</div>
<p>值得一提的是，这种方法，前面的变量不能使用后面的变量，只能使用前面已定义好了的变量。如果是这样：</p>
<div class="highlight-makefile notranslate"><div class="highlight"><pre><span></span><span class="nv">y</span> <span class="o">:=</span> <span class="k">$(</span>x<span class="k">)</span> bar
<span class="nv">x</span> <span class="o">:=</span> foo
</pre></div>
</div>
<p>那么，y的值是“bar”，而不是“foo bar”。</p>
<p>上面都是一些比较简单的变量使用了，让我们来看一个复杂的例子，其中包括了make的函数、条件表达式和一个系统变量“MAKELEVEL”的使用：</p>
<div class="highlight-makefile notranslate"><div class="highlight"><pre><span></span><span class="cp">ifeq (0,${MAKELEVEL})</span>
<span class="nv">cur-dir</span> <span class="o">:=</span> <span class="k">$(</span>shell <span class="nb">pwd</span><span class="k">)</span>
<span class="nv">whoami</span> <span class="o">:=</span> <span class="k">$(</span>shell whoami<span class="k">)</span>
<span class="nv">host-type</span> <span class="o">:=</span> <span class="k">$(</span>shell arch<span class="k">)</span>
<span class="nv">MAKE</span> <span class="o">:=</span> <span class="si">${</span><span class="nv">MAKE</span><span class="si">}</span> host-type<span class="o">=</span><span class="si">${</span><span class="nv">host</span><span class="p">-type</span><span class="si">}</span> <span class="nv">whoami</span><span class="o">=</span><span class="si">${</span><span class="nv">whoami</span><span class="si">}</span>
<span class="cp">endif</span>
</pre></div>
</div>
<p>关于条件表达式和函数，我们在后面再说，对于系统变量“MAKELEVEL”，其意思是，如果我们的make有一个嵌套执行的动作（参见前面的“嵌套使用make”），那么，这个变量会记录了我们的当前Makefile的调用层数。</p>
<p>下面再介绍两个定义变量时我们需要知道的，请先看一个例子，如果我们要定义一个变量，其值是一个空格，那么我们可以这样来：</p>
<div class="highlight-makefile notranslate"><div class="highlight"><pre><span></span><span class="nv">nullstring</span> <span class="o">:=</span>
<span class="nv">space</span> <span class="o">:=</span> <span class="k">$(</span>nullstring<span class="k">)</span> <span class="c1"># end of the line</span>
</pre></div>
</div>
<p>nullstring是一个Empty变量，其中什么也没有，而我们的space的值是一个空格。因为在操作符的右边是很难描述一个空格的，这里采用的技术很管用，先用一个Empty变量来标明变量的值开始了，而后面采用“#”注释符来表示变量定义的终止，这样，我们可以定义出其值是一个空格的变量。请注意这里关于“#”的使用，注释符“#”的这种特性值得我们注意，如果我们这样定义一个变量：</p>
<div class="highlight-makefile notranslate"><div class="highlight"><pre><span></span><span class="nv">dir</span> <span class="o">:=</span> /foo/bar <span class="c1"># directory to put the frobs in</span>
</pre></div>
</div>
<p>dir这个变量的值是“/foo/bar”，后面还跟了4个空格，如果我们这样使用这样变量来指定别的目录——“$(dir)/file”那么就完蛋了。</p>
<p>还有一个比较有用的操作符是 <code class="docutils literal notranslate"><span class="pre">?=</span></code> ，先看示例：</p>
<div class="highlight-makefile notranslate"><div class="highlight"><pre><span></span><span class="nv">FOO</span> <span class="o">?=</span> bar
</pre></div>
</div>
<p>其含义是，如果FOO没有被定义过，那么变量FOO的值就是“bar”，如果FOO先前被定义过，那么这条语将什么也不做，其等价于：</p>
<div class="highlight-makefile notranslate"><div class="highlight"><pre><span></span><span class="cp">ifeq ($(origin FOO), undefined)</span>
<span class="nv">FOO</span> <span class="o">=</span> bar
<span class="cp">endif</span>
</pre></div>
</div>
</section>
<section id="id4">
<h2>变量高级用法<a class="headerlink" href="#id4" title="永久链接至标题"></a></h2>
<p>这里介绍两种变量的高级使用方法，第一种是变量值的替换。</p>
<p>我们可以替换变量中的共有的部分，其格式是 <code class="docutils literal notranslate"><span class="pre">$(var:a=b)</span></code> 或是 <code class="docutils literal notranslate"><span class="pre">${var:a=b}</span></code> ，其意思是，把变量“var”中所有以“a”字串“结尾”的“a”替换成“b”字串。这里的“结尾”意思是“空格”或是“结束符”。</p>
<p>还是看一个示例吧：</p>
<div class="highlight-makefile notranslate"><div class="highlight"><pre><span></span><span class="nv">foo</span> <span class="o">:=</span> a.o b.o c.o
<span class="nv">bar</span> <span class="o">:=</span> <span class="k">$(</span>foo:.o<span class="o">=</span>.c<span class="k">)</span>
</pre></div>
</div>
<p>这个示例中，我们先定义了一个 <code class="docutils literal notranslate"><span class="pre">$(foo)</span></code> 变量，而第二行的意思是把 <code class="docutils literal notranslate"><span class="pre">$(foo)</span></code> 中所有以
<code class="docutils literal notranslate"><span class="pre">.o</span></code> 字串“结尾”全部替换成 <code class="docutils literal notranslate"><span class="pre">.c</span></code> ，所以我们的 <code class="docutils literal notranslate"><span class="pre">$(bar)</span></code> 的值就是“a.c b.c c.c”。</p>
<p>另外一种变量替换的技术是以“静态模式”（参见前面章节）定义的，如：</p>
<div class="highlight-makefile notranslate"><div class="highlight"><pre><span></span><span class="nv">foo</span> <span class="o">:=</span> a.o b.o c.o
<span class="nv">bar</span> <span class="o">:=</span> <span class="k">$(</span>foo:%.o<span class="o">=</span>%.c<span class="k">)</span>
</pre></div>
</div>
<p>这依赖于被替换字串中的有相同的模式，模式中必须包含一个 <code class="docutils literal notranslate"><span class="pre">%</span></code> 字符，这个例子同样让
<code class="docutils literal notranslate"><span class="pre">$(bar)</span></code> 变量的值为“a.c b.c c.c”。</p>
<p>第二种高级用法是——“把变量的值再当成变量”。先看一个例子：</p>
<div class="highlight-makefile notranslate"><div class="highlight"><pre><span></span><span class="nv">x</span> <span class="o">=</span> y
<span class="nv">y</span> <span class="o">=</span> z
<span class="nv">a</span> <span class="o">:=</span> <span class="k">$($(</span>x<span class="k">))</span>
</pre></div>
</div>
<p>在这个例子中，$(x)的值是“y”，所以$($(x))就是$(y)，于是$(a)的值就是“z”。（注意，是“x=y”，而不是“x=$(y)”）</p>
<p>我们还可以使用更多的层次：</p>
<div class="highlight-makefile notranslate"><div class="highlight"><pre><span></span><span class="nv">x</span> <span class="o">=</span> y
<span class="nv">y</span> <span class="o">=</span> z
<span class="nv">z</span> <span class="o">=</span> u
<span class="nv">a</span> <span class="o">:=</span> <span class="k">$($($(</span>x<span class="k">)))</span>
</pre></div>
</div>
<p>这里的 <code class="docutils literal notranslate"><span class="pre">$(a)</span></code> 的值是“u”，相关的推导留给读者自己去做吧。</p>
<p>让我们再复杂一点，使用上“在变量定义中使用变量”的第一个方式，来看一个例子：</p>
<div class="highlight-makefile notranslate"><div class="highlight"><pre><span></span><span class="nv">x</span> <span class="o">=</span> <span class="k">$(</span>y<span class="k">)</span>
<span class="nv">y</span> <span class="o">=</span> z
<span class="nv">z</span> <span class="o">=</span> Hello
<span class="nv">a</span> <span class="o">:=</span> <span class="k">$($(</span>x<span class="k">))</span>
</pre></div>
</div>
<p>这里的 <code class="docutils literal notranslate"><span class="pre">$($(x))</span></code> 被替换成了 <code class="docutils literal notranslate"><span class="pre">$($(y))</span></code> ，因为 <code class="docutils literal notranslate"><span class="pre">$(y)</span></code> 值是“z”，所以，最终结果是：
<code class="docutils literal notranslate"><span class="pre">a:=$(z)</span></code> ，也就是“Hello”。</p>
<p>再复杂一点，我们再加上函数：</p>
<div class="highlight-makefile notranslate"><div class="highlight"><pre><span></span><span class="nv">x</span> <span class="o">=</span> variable1
<span class="nv">variable2</span> <span class="o">:=</span> Hello
<span class="nv">y</span> <span class="o">=</span> <span class="k">$(</span>subst <span class="m">1</span>,2,<span class="k">$(</span>x<span class="k">))</span>
<span class="nv">z</span> <span class="o">=</span> y
<span class="nv">a</span> <span class="o">:=</span> <span class="k">$($($(</span>z<span class="k">)))</span>
</pre></div>
</div>
<p>这个例子中， <code class="docutils literal notranslate"><span class="pre">$($($(z)))</span></code> 扩展为 <code class="docutils literal notranslate"><span class="pre">$($(y))</span></code> ，而其再次被扩展为
<code class="docutils literal notranslate"><span class="pre">$($(subst</span> <span class="pre">1,2,$(x)))</span></code> 。 <code class="docutils literal notranslate"><span class="pre">$(x)</span></code> 的值是“variable1”，subst函数把“variable1”中的所有“1”字串替换成“2”字串，于是，“variable1”变成 “variable2”，再取其值，所以，最终，
<code class="docutils literal notranslate"><span class="pre">$(a)</span></code> 的值就是 <code class="docutils literal notranslate"><span class="pre">$(variable2)</span></code> 的值——“Hello”。（喔，好不容易）</p>
<p>在这种方式中，或要可以使用多个变量来组成一个变量的名字，然后再取其值：</p>
<div class="highlight-makefile notranslate"><div class="highlight"><pre><span></span><span class="nv">first_second</span> <span class="o">=</span> Hello
<span class="nv">a</span> <span class="o">=</span> first
<span class="nv">b</span> <span class="o">=</span> second
<span class="nv">all</span> <span class="o">=</span> <span class="k">$(</span><span class="nv">$a_$b</span><span class="k">)</span>
</pre></div>
</div>
<p>这里的 <code class="docutils literal notranslate"><span class="pre">$a_$b</span></code> 组成了“first_second”，于是， <code class="docutils literal notranslate"><span class="pre">$(all)</span></code> 的值就是“Hello”。</p>
<p>再来看看结合第一种技术的例子：</p>
<div class="highlight-makefile notranslate"><div class="highlight"><pre><span></span><span class="nv">a_objects</span> <span class="o">:=</span> a.o b.o c.o
<span class="nv">1_objects</span> <span class="o">:=</span> <span class="m">1</span>.o <span class="m">2</span>.o <span class="m">3</span>.o
<span class="nv">sources</span> <span class="o">:=</span> <span class="k">$($(</span>a1<span class="k">)</span>_objects:.o<span class="o">=</span>.c<span class="k">)</span>
</pre></div>
</div>
<p>这个例子中，如果 <code class="docutils literal notranslate"><span class="pre">$(a1)</span></code> 的值是“a”的话，那么， <code class="docutils literal notranslate"><span class="pre">$(sources)</span></code> 的值就是“a.c b.c c.c”；如果 <code class="docutils literal notranslate"><span class="pre">$(a1)</span></code> 的值是“1”，那么 <code class="docutils literal notranslate"><span class="pre">$(sources)</span></code> 的值是“1.c 2.c 3.c”。</p>
<p>再来看一个这种技术和“函数”与“条件语句”一同使用的例子：</p>
<div class="highlight-makefile notranslate"><div class="highlight"><pre><span></span><span class="cp">ifdef do_sort</span>
func :<span class="o">=</span> sort
<span class="cp">else</span>
func :<span class="o">=</span> strip
<span class="cp">endif</span>
<span class="nv">bar</span> <span class="o">:=</span> a d b g q c
<span class="nv">foo</span> <span class="o">:=</span> <span class="k">$($(</span>func<span class="k">)</span> <span class="k">$(</span>bar<span class="k">))</span>
</pre></div>
</div>
<p>这个示例中，如果定义了“do_sort”，那么： <code class="docutils literal notranslate"><span class="pre">foo</span> <span class="pre">:=</span> <span class="pre">$(sort</span> <span class="pre">a</span> <span class="pre">d</span> <span class="pre">b</span> <span class="pre">g</span> <span class="pre">q</span> <span class="pre">c)</span></code> ，于是
<code class="docutils literal notranslate"><span class="pre">$(foo)</span></code> 的值就是 “a b c d g q”，而如果没有定义“do_sort”，那么：
<code class="docutils literal notranslate"><span class="pre">foo</span> <span class="pre">:=</span> <span class="pre">$(strip</span> <span class="pre">a</span> <span class="pre">d</span> <span class="pre">b</span> <span class="pre">g</span> <span class="pre">q</span> <span class="pre">c)</span></code> ，调用的就是strip函数。</p>
<p>当然，“把变量的值再当成变量”这种技术，同样可以用在操作符的左边:</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span>dir = foo
$(dir)_sources := $(wildcard $(dir)/*.c)
define $(dir)_print
lpr $($(dir)_sources)
endef
</pre></div>
</div>
<p>这个例子中定义了三个变量：“dir”，“foo_sources”和“foo_print”。</p>
</section>
<section id="id5">
<h2>追加变量值<a class="headerlink" href="#id5" title="永久链接至标题"></a></h2>
<p>我们可以使用 <code class="docutils literal notranslate"><span class="pre">+=</span></code> 操作符给变量追加值，如：</p>
<div class="highlight-makefile notranslate"><div class="highlight"><pre><span></span><span class="nv">objects</span> <span class="o">=</span> main.o foo.o bar.o utils.o
<span class="nv">objects</span> <span class="o">+=</span> another.o
</pre></div>
</div>
<p>于是，我们的 <code class="docutils literal notranslate"><span class="pre">$(objects)</span></code> 值变成：“main.o foo.o bar.o utils.o another.o”（another.o被追加进去了）</p>
<p>使用 <code class="docutils literal notranslate"><span class="pre">+=</span></code> 操作符，可以模拟为下面的这种例子：</p>
<div class="highlight-makefile notranslate"><div class="highlight"><pre><span></span><span class="nv">objects</span> <span class="o">=</span> main.o foo.o bar.o utils.o
<span class="nv">objects</span> <span class="o">:=</span> <span class="k">$(</span>objects<span class="k">)</span> another.o
</pre></div>
</div>
<p>所不同的是，用 <code class="docutils literal notranslate"><span class="pre">+=</span></code> 更为简洁。</p>
<p>如果变量之前没有定义过，那么， <code class="docutils literal notranslate"><span class="pre">+=</span></code> 会自动变成 <code class="docutils literal notranslate"><span class="pre">=</span></code> ，如果前面有变量定义，那么 <code class="docutils literal notranslate"><span class="pre">+=</span></code> 会继承于前次操作的赋值符。如果前一次的是 <code class="docutils literal notranslate"><span class="pre">:=</span></code> ，那么 <code class="docutils literal notranslate"><span class="pre">+=</span></code> 会以 <code class="docutils literal notranslate"><span class="pre">:=</span></code> 作为其赋值符，如：</p>
<div class="highlight-makefile notranslate"><div class="highlight"><pre><span></span><span class="nv">variable</span> <span class="o">:=</span> value
<span class="nv">variable</span> <span class="o">+=</span> more
</pre></div>
</div>
<p>等价于：</p>
<div class="highlight-makefile notranslate"><div class="highlight"><pre><span></span><span class="nv">variable</span> <span class="o">:=</span> value
<span class="nv">variable</span> <span class="o">:=</span> <span class="k">$(</span>variable<span class="k">)</span> more
</pre></div>
</div>
<p>但如果是这种情况：</p>
<div class="highlight-makefile notranslate"><div class="highlight"><pre><span></span><span class="nv">variable</span> <span class="o">=</span> value
<span class="nv">variable</span> <span class="o">+=</span> more
</pre></div>
</div>
<p>由于前次的赋值符是 <code class="docutils literal notranslate"><span class="pre">=</span></code> ，所以 <code class="docutils literal notranslate"><span class="pre">+=</span></code> 也会以 <code class="docutils literal notranslate"><span class="pre">=</span></code> 来做为赋值，那么岂不会发生变量的递补归定义，这是很不好的，所以make会自动为我们解决这个问题，我们不必担心这个问题。</p>
</section>
<section id="override">
<h2>override 指示符<a class="headerlink" href="#override" title="永久链接至标题"></a></h2>
<p>如果有变量是通常make的命令行参数设置的，那么Makefile中对这个变量的赋值会被忽略。如果你想在Makefile中设置这类参数的值，那么，你可以使用“override”指示符。其语法是:</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">override</span> <span class="o">&lt;</span><span class="n">variable</span><span class="o">&gt;</span><span class="p">;</span> <span class="o">=</span> <span class="o">&lt;</span><span class="n">value</span><span class="o">&gt;</span><span class="p">;</span>
<span class="n">override</span> <span class="o">&lt;</span><span class="n">variable</span><span class="o">&gt;</span><span class="p">;</span> <span class="o">:=</span> <span class="o">&lt;</span><span class="n">value</span><span class="o">&gt;</span><span class="p">;</span>
</pre></div>
</div>
<p>当然，你还可以追加:</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">override</span> <span class="o">&lt;</span><span class="n">variable</span><span class="o">&gt;</span><span class="p">;</span> <span class="o">+=</span> <span class="o">&lt;</span><span class="n">more</span> <span class="n">text</span><span class="o">&gt;</span><span class="p">;</span>
</pre></div>
</div>
<p>对于多行的变量定义，我们用define指示符，在define指示符前，也同样可以使用override指示符，如:</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">override</span> <span class="n">define</span> <span class="n">foo</span>
<span class="n">bar</span>
<span class="n">endef</span>
</pre></div>
</div>
</section>
<section id="id6">
<h2>多行变量<a class="headerlink" href="#id6" title="永久链接至标题"></a></h2>
<p>还有一种设置变量值的方法是使用define关键字。使用define关键字设置变量的值可以有换行，这有利于定义一系列的命令（前面我们讲过“命令包”的技术就是利用这个关键字）。</p>
<p>define指示符后面跟的是变量的名字，而重起一行定义变量的值，定义是以endef 关键字结束。其工作方式和“=”操作符一样。变量的值可以包含函数、命令、文字，或是其它变量。因为命令需要以[Tab]键开头，所以如果你用define定义的命令变量中没有以 <code class="docutils literal notranslate"><span class="pre">Tab</span></code> 键开头，那么make 就不会把其认为是命令。</p>
<p>下面的这个示例展示了define的用法:</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span>define two-lines
echo foo
echo $(bar)
endef
</pre></div>
</div>
</section>
<section id="id7">
<h2>环境变量<a class="headerlink" href="#id7" title="永久链接至标题"></a></h2>
<p>make运行时的系统环境变量可以在make开始运行时被载入到Makefile文件中，但是如果Makefile中已定义了这个变量，或是这个变量由make命令行带入，那么系统的环境变量的值将被覆盖。（如果make指定了“-e”参数，那么，系统环境变量将覆盖Makefile中定义的变量）</p>
<p>因此，如果我们在环境变量中设置了 <code class="docutils literal notranslate"><span class="pre">CFLAGS</span></code> 环境变量，那么我们就可以在所有的Makefile中使用这个变量了。这对于我们使用统一的编译参数有比较大的好处。如果Makefile中定义了CFLAGS，那么则会使用Makefile中的这个变量，如果没有定义则使用系统环境变量的值，一个共性和个性的统一，很像“全局变量”和“局部变量”的特性。</p>
<p>当make嵌套调用时（参见前面的“嵌套调用”章节），上层Makefile中定义的变量会以系统环境变量的方式传递到下层的Makefile 中。当然，默认情况下，只有通过命令行设置的变量会被传递。而定义在文件中的变量，如果要向下层Makefile传递，则需要使用export关键字来声明。（参见前面章节）</p>
<p>当然，我并不推荐把许多的变量都定义在系统环境中，这样，在我们执行不用的Makefile时，拥有的是同一套系统变量，这可能会带来更多的麻烦。</p>
</section>
<section id="id8">
<h2>目标变量<a class="headerlink" href="#id8" title="永久链接至标题"></a></h2>
<p>前面我们所讲的在Makefile中定义的变量都是“全局变量”，在整个文件，我们都可以访问这些变量。当然，“自动化变量”除外，如 <code class="docutils literal notranslate"><span class="pre">$&lt;</span></code> 等这种类量的自动化变量就属于“规则型变量”，这种变量的值依赖于规则的目标和依赖目标的定义。</p>
<p>当然，我也同样可以为某个目标设置局部变量，这种变量被称为“Target-specific Variable”，它可以和“全局变量”同名，因为它的作用范围只在这条规则以及连带规则中，所以其值也只在作用范围内有效。而不会影响规则链以外的全局变量的值。</p>
<p>其语法是：</p>
<div class="highlight-makefile notranslate"><div class="highlight"><pre><span></span><span class="nf">&lt;target ...&gt; </span><span class="o">:</span> &lt;<span class="n">variable</span>-<span class="n">assignment</span>&gt;;
<span class="nf">&lt;target ...&gt; </span><span class="o">:</span> <span class="n">overide</span> &lt;<span class="n">variable</span>-<span class="n">assignment</span>&gt;
</pre></div>
</div>
<p>&lt;variable-assignment&gt;;可以是前面讲过的各种赋值表达式，如 <code class="docutils literal notranslate"><span class="pre">=</span></code> 、 <code class="docutils literal notranslate"><span class="pre">:=</span></code> 、 <code class="docutils literal notranslate"><span class="pre">+=</span></code>
或是 <code class="docutils literal notranslate"><span class="pre">?=</span></code> 。第二个语法是针对于make命令行带入的变量，或是系统环境变量。</p>
<p>这个特性非常的有用，当我们设置了这样一个变量，这个变量会作用到由这个目标所引发的所有的规则中去。如：</p>
<div class="highlight-makefile notranslate"><div class="highlight"><pre><span></span><span class="nf">prog </span><span class="o">:</span> <span class="n">CFLAGS</span> = -<span class="n">g</span>
<span class="nf">prog </span><span class="o">:</span> <span class="n">prog</span>.<span class="n">o</span> <span class="n">foo</span>.<span class="n">o</span> <span class="n">bar</span>.<span class="n">o</span>
<span class="k">$(</span>CC<span class="k">)</span> <span class="k">$(</span>CFLAGS<span class="k">)</span> prog.o foo.o bar.o
<span class="nf">prog.o </span><span class="o">:</span> <span class="n">prog</span>.<span class="n">c</span>
<span class="k">$(</span>CC<span class="k">)</span> <span class="k">$(</span>CFLAGS<span class="k">)</span> prog.c
<span class="nf">foo.o </span><span class="o">:</span> <span class="n">foo</span>.<span class="n">c</span>
<span class="k">$(</span>CC<span class="k">)</span> <span class="k">$(</span>CFLAGS<span class="k">)</span> foo.c
<span class="nf">bar.o </span><span class="o">:</span> <span class="n">bar</span>.<span class="n">c</span>
<span class="k">$(</span>CC<span class="k">)</span> <span class="k">$(</span>CFLAGS<span class="k">)</span> bar.c
</pre></div>
</div>
<p>在这个示例中，不管全局的 <code class="docutils literal notranslate"><span class="pre">$(CFLAGS)</span></code> 的值是什么，在prog目标，以及其所引发的所有规则中（prog.o foo.o bar.o的规则）， <code class="docutils literal notranslate"><span class="pre">$(CFLAGS)</span></code> 的值都是 <code class="docutils literal notranslate"><span class="pre">-g</span></code></p>
</section>
<section id="id9">
<h2>模式变量<a class="headerlink" href="#id9" title="永久链接至标题"></a></h2>
<p>在GNU的make中，还支持模式变量（Pattern-specific Variable），通过上面的目标变量中，我们知道，变量可以定义在某个目标上。模式变量的好处就是，我们可以给定一种“模式”，可以把变量定义在符合这种模式的所有目标上。</p>
<p>我们知道，make的“模式”一般是至少含有一个 <code class="docutils literal notranslate"><span class="pre">%</span></code> 的，所以，我们可以以如下方式给所有以 <code class="docutils literal notranslate"><span class="pre">.o</span></code>
结尾的目标定义目标变量：</p>
<div class="highlight-makefile notranslate"><div class="highlight"><pre><span></span><span class="nf">%.o </span><span class="o">:</span> <span class="n">CFLAGS</span> = -<span class="n">O</span>
</pre></div>
</div>
<p>同样，模式变量的语法和“目标变量”一样：</p>
<div class="highlight-makefile notranslate"><div class="highlight"><pre><span></span><span class="nf">&lt;pattern ...&gt;; </span><span class="o">:</span> &lt;<span class="n">variable</span>-<span class="n">assignment</span>&gt;;
<span class="nf">&lt;pattern ...&gt;; </span><span class="o">:</span> <span class="n">override</span> &lt;<span class="n">variable</span>-<span class="n">assignment</span>&gt;;
</pre></div>
</div>
<p>override同样是针对于系统环境传入的变量，或是make命令行指定的变量。</p>
</section>
</section>
</div>
</div>
<footer><div class="rst-footer-buttons" role="navigation" aria-label="Footer">
<a href="recipes.html" class="btn btn-neutral float-left" title="书写命令" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
<a href="conditionals.html" class="btn btn-neutral float-right" title="使用条件判断" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
</div>
<hr/>
<div role="contentinfo">
<p>&#169; 版权所有 2014-2019, 作者：陈皓；排版：SeisMan.
<span class="lastupdated">最后更新于 2022年5月22日.
</span></p>
</div>
Built with <a href="https://www.sphinx-doc.org/">Sphinx</a> using a
<a href="https://github.com/readthedocs/sphinx_rtd_theme">theme</a>
provided by <a href="https://readthedocs.org">Read the Docs</a>.
</footer>
</div>
</div>
</section>
</div>
<script>
jQuery(function () {
SphinxRtdTheme.Navigation.enable(true);
});
</script>
</body>
</html>