fix rst format

This commit is contained in:
Dongdong Tian
2015-11-09 14:41:39 +08:00
parent 956141d25f
commit 51ddffaab3
6 changed files with 191 additions and 192 deletions

View File

@@ -133,86 +133,86 @@ make会在自己的“隐含规则”库中寻找可以用的规则如果找
关于命令的变量。
~~~~~~~~~~~~~~~~
- 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”。
- ``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文法分析器参数。
- ``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`` 存在那么就直接调用C的编译器的隐含规则如果没有 ``.c`` 文件,但有一个 ``.y`` 文件那么Yacc的隐含规则会被调用生成 ``.c`` 文件然后再调用C编译的隐含规则最终由 ``.c`` 生成 ``.o`` 文件,达到目标。
我们把这种 ``.c`` 的文件或是目标叫做中间目标。不管怎么样make会努力自动推导生成目标的一切方法不管中间目标有多少其都会执着地把所有的隐含规则和你书写的规则全部合起来分析努力达到目标所以有些时候可能会让你觉得奇怪怎么我的目标会这样生成怎么我的 makefile发疯了
在默认情况下,对于中间目标,它和一般的目标有两个地方所不同:第一个不同是除非中间的目标不存在,才会引发中间规则。第二个不同的是,只要目标成功产生,那么,产生最终目标过程中,所产生的中间目标文件会被以 ``rm -f`` 删除。
通常一个被makefile指定成目标或是依赖目标的文件不能被当作中介。然而你可以明显地说明一个文件或是目标是中介目标你可以使用伪目标 ``.INTERMEDIATE`` 来强制声明。(如:.INTERMEDIATE : mid
通常一个被makefile指定成目标或是依赖目标的文件不能被当作中介。然而你可以明显地说明一个文件或是目标是中介目标你可以使用伪目标 ``.INTERMEDIATE`` 来强制声明。(如: ``.INTERMEDIATE : mid``
你也可以阻止make自动删除中间目标要做到这一点你可以使用伪目标.SECONDARY来强制声明(如:.SECONDARY : sec。你还可以把你的目标以模式的方式来指定%.o成伪目标“.PRECIOUS的依赖目标,以保存被隐含规则所生成的中间文件。
你也可以阻止make自动删除中间目标要做到这一点你可以使用伪目标 ``.SECONDARY`` 来强制声明(如: ``.SECONDARY : sec`` )。你还可以把你的目标,以模式的方式来指定(如: ``%.o`` )成伪目标 ``.PRECIOUS`` 的依赖目标,以保存被隐含规则所生成的中间文件。
在“隐含规则链”中禁止同一个目标出现两次或两次以上这样一来就可防止在make自动推导时出现无限递归的情况。
Make会优化一些特殊的隐含规则而不生成中间文件。如从文件“foo.c”生成目标程序“foo”按道理make会编译生成中间文件 “foo.o”然后链接成“foo”但在实际情况下这一动作可以被一条“cc”的命令完成cc o foo foo.c于是优化过的规则就不会生成中间文件。
Make会优化一些特殊的隐含规则而不生成中间文件。如从文件 ``foo.c`` 生成目标程序 ``foo`` 按道理make会编译生成中间文件 ``foo.o`` ,然后链接成 ``foo`` ,但在实际情况下,这一动作可以被一条 ``cc`` 的命令完成( ``cc o foo foo.c`` ),于是优化过的规则就不会生成中间文件。
定义模式规则
------------
你可以使用模式规则来定义一个隐含规则。一个模式规则就好像一个一般的规则,只是在规则中,目标的定义需要有“%”字符。“%”的意思是表示一个或多个任意字符。在依赖目标中同样可以使用“%”,只是依赖目标中的“%”的取值,取决于其目标。
你可以使用模式规则来定义一个隐含规则。一个模式规则就好像一个一般的规则,只是在规则中,目标的定义需要有 ``%`` 字符。 ``%`` 的意思是表示一个或多个任意字符。在依赖目标中同样可以使用 ``%`` ,只是依赖目标中的 ``%`` 的取值,取决于其目标。
有一点需要注意的是,“%”的展开发生在变量和函数的展开之后变量和函数的展开发生在make载入Makefile时而模式规则中的“%”则发生在运行时。
有一点需要注意的是, ``%`` 的展开发生在变量和函数的展开之后变量和函数的展开发生在make载入Makefile时而模式规则中的 ``%`` 则发生在运行时。
模式规则介绍
~~~~~~~~~~~~
模式规则中,至少在规则的目标定义中要包含“%”,否则,就是一般的规则。目标中的“%”定义表示对文件名的匹配,“%”表示长度任意的非空字符串。例如:“%.c”表示以“.c”结尾的文件名文件名的长度至少为3而“s.%.c”则表示以“s.”开头,“.c”结尾的文件名文件名的长度至少为5
模式规则中,至少在规则的目标定义中要包含 ``%`` ,否则,就是一般的规则。目标中的 ``%`` 定义表示对文件名的匹配, ``%`` 表示长度任意的非空字符串。例如: ``%.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
其含义是,指出了怎么从所有的 ``.c`` 文件生成相应的 ``.o`` 文件的规则。如果要生成的目标是 ``a.o b.o`` ,那么 ``%c`` 就是 ``a.c b.c``
一旦依赖目标中的“%”模式被确定那么make会被要求去匹配当前目录下所有的文件名一旦找到make就会规则下的命令所以在模式规则中目标可能会是多个的如果有模式匹配出多个目标make就会产生所有的模式目标此时make关心的是依赖的文件名和生成目标的命令这两件事。
一旦依赖目标中的 ``%`` 模式被确定那么make会被要求去匹配当前目录下所有的文件名一旦找到make就会规则下的命令所以在模式规则中目标可能会是多个的如果有模式匹配出多个目标make就会产生所有的模式目标此时make关心的是依赖的文件名和生成目标的命令这两件事。
模式规则示例
~~~~~~~~~~~~
@@ -224,7 +224,7 @@ Make会优化一些特殊的隐含规则而不生成中间文件。如
%.o : %.c
$(CC) -c $(CFLAGS) $(CPPFLAGS) $< -o $@
其中,“$@”表示所有的目标的挨个值,“$<”表示了所有依赖目标的挨个值。这些奇怪的变量我们叫“自动化变量”,后面会详细讲述。
其中, ``$@`` 表示所有的目标的挨个值, ``$<`` 表示了所有依赖目标的挨个值。这些奇怪的变量我们叫“自动化变量”,后面会详细讲述。
下面的这个例子中有两个目标是模式的:
@@ -233,7 +233,7 @@ Make会优化一些特殊的隐含规则而不生成中间文件。如
%.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`` 文件的依赖关系也写好,那么,所有的目标都会得到满足)
这条规则告诉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`` 文件的依赖关系也写好,那么,所有的目标都会得到满足)
自动化变量
~~~~~~~~~~
@@ -244,36 +244,36 @@ Make会优化一些特殊的隐含规则而不生成中间文件。如
下面是所有的自动化变量及其说明:
- $@: 表示规则中的目标文件集。在模式规则中,如果有多个目标,那么,“$@”就是匹配于目标中模式定义的集合。
- $%: 仅当目标是函数库文件中,表示规则中的目标成员名。例如,如果一个目标是foo.a(bar.o)”,那么,“$%”就是“bar.o”“$@”就是“foo.a”。如果目标不是函数库文件Unix下是[.a]Windows下是[.lib]),那么,其值为空。
- $<: 依赖目标中的第一个目标名字。如果依赖目标是以模式(即“%”)定义的,那么“$<”将是符合模式的一系列的文件集。注意,其是一个一个取出来的。
- $?: 所有比目标新的依赖目标的集合。以空格分隔。
- $^:所有的依赖目标的集合。以空格分隔。如果在依赖目标中有多个重复的,那个这个变量会去除重复的依赖目标,只保留一份。
- $+:这个变量很像“$^”,也是所有依赖目标的集合。只是它不去除重复的依赖目标。
- $*: 这个变量表示目标模式中“%”及其之前的部分。如果目标是dir/a.foo.b,并且目标的模式是“a.%.b”那么“$*”的值就是“dir/a.foo。这个变量对于构造有关联的文件名是比较有较。如果目标中没有模式的定义,那么“$*”也就不能被推导出但是如果目标文件的后缀是make所识别的那么“$*就是除了后缀的那一部分。例如:如果目标是“foo.c”因为“.c”是make所能识别的后缀名所以“$*”的值就是“foo”。这个特性是GNU make的很有可能不兼容于其它版本的make所以你应该尽量避免使用“$*除非是在隐含规则或是静态模式中。如果目标中的后缀是make所不能识别的那么“$*”就是空值。
- ``$@`` : 表示规则中的目标文件集。在模式规则中,如果有多个目标,那么, ``$@`` 就是匹配于目标中模式定义的集合。
- ``$%`` : 仅当目标是函数库文件中,表示规则中的目标成员名。例如,如果一个目标是 ``foo.a(bar.o)`` ,那么, ``$%`` 就是 ``bar.o`` ``$@`` 就是 ``foo.a`` 。如果目标不是函数库文件Unix下是 ``.a`` Windows下是 ``.lib`` ),那么,其值为空。
- ``$<`` : 依赖目标中的第一个目标名字。如果依赖目标是以模式(即 ``%`` )定义的,那么 ``$<`` 将是符合模式的一系列的文件集。注意,其是一个一个取出来的。
- ``$?`` : 所有比目标新的依赖目标的集合。以空格分隔。
- ``$^`` : 所有的依赖目标的集合。以空格分隔。如果在依赖目标中有多个重复的,那个这个变量会去除重复的依赖目标,只保留一份。
- ``$+`` : 这个变量很像 ``$^`` ,也是所有依赖目标的集合。只是它不去除重复的依赖目标。
- ``$*`` : 这个变量表示目标模式中 ``%`` 及其之前的部分。如果目标是 ``dir/a.foo.b`` ,并且目标的模式是 ``a.%.b`` ,那么, ``$*`` 的值就是 ``dir/a.foo`` 。这个变量对于构造有关联的文件名是比较有较。如果目标中没有模式的定义,那么 ``$*`` 也就不能被推导出但是如果目标文件的后缀是make所识别的那么 ``$*`` 就是除了后缀的那一部分。例如:如果目标是 ``foo.c`` ,因为 ``.c`` 是make所能识别的后缀名所以 ``$*`` 的值就是 ``foo`` 。这个特性是GNU make的很有可能不兼容于其它版本的make所以你应该尽量避免使用 ``$*`` 除非是在隐含规则或是静态模式中。如果目标中的后缀是make所不能识别的那么 ``$*`` 就是空值。
当你希望只对更新过的依赖文件进行操作时,“$?”在显式规则中很有用,例如,假设有一个函数库文件叫“lib”其由其它几个object文件更新。那么把object文件打包的比较有效率的Makefile规则是
当你希望只对更新过的依赖文件进行操作时, ``$?`` 在显式规则中很有用,例如,假设有一个函数库文件叫 ``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`` 字样。这是GNU make中老版本的特性在新版本中我们使用函数 ``dir````notdir`` 就可以做到了。 ``D`` 的含义就是Directory就是目录 ``F`` 的含义就是File就是文件。
下面是对于上面的七个变量分别加上“D”或是“F”的含义:
下面是对于上面的七个变量分别加上 ``D`` 或是 ``F`` 的含义:
``$(@D)``
表示“$@”的目录部分(不以斜杠作为结尾),如果“$@”值是“dir/foo.o”那么“$(@D)”就是“dir”而如果“$@”中没有包含斜杠的话,其值就是“.”(当前目录)。
表示 ``$@`` 的目录部分(不以斜杠作为结尾),如果 ``$@`` 值是 ``dir/foo.o`` ,那么 ``$(@D)`` 就是 ``dir`` ,而如果 ``$@`` 中没有包含斜杠的话,其值就是 ``.`` (当前目录)。
``$(@F)``
表示“$@”的文件部分,如果“$@”值是“dir/foo.o”那么“$(@F)”就是“foo.o”“$(@F)”相当于函数“$(notdir $@)
表示 ``$@`` 的文件部分,如果 ``$@`` 值是 ``dir/foo.o`` ,那么 ``$(@F)`` 就是 ``foo.o`` ``$(@F)`` 相当于函数 ``$(notdir $@)``
``$(*D)``, ``$(*F)``
和上面所述的同理,也是取文件的目录部分和文件部分。对于上面的那个例子,\ ``$(*D)``\ 返回“dir”而\ ``$(*F)``\ 返回“foo”
和上面所述的同理,也是取文件的目录部分和文件部分。对于上面的那个例子, ``$(*D)`` 返回 ``dir`` ,而 ``$(*F)`` 返回 ``foo``
``$(%D)``, ``$(%F)``
分别表示了函数包文件成员的目录部分和文件部分。这对于形同archive(member)形式的目标中的“member“中包含了不同的目录很有用。
分别表示了函数包文件成员的目录部分和文件部分。这对于形同 ``archive(member)`` 形式的目标中的 ``member`` 中包含了不同的目录很有用。
``$(<D)``, ``$(<F)``
分别表示依赖文件的目录部分和文件部分。
@@ -287,16 +287,16 @@ Make会优化一些特殊的隐含规则而不生成中间文件。如
``$(?D)``, ``$(?F)``
分别表示被更新的依赖文件的目录部分和文件部分。
最后想提醒一下的是,对于“$<”,为了避免产生不必要的麻烦,我们最好给$后面的那个特定字符都加上圆括号,比如,“$(<)”就要比“$<”要好一些。
最后想提醒一下的是,对于 ``$<`` ,为了避免产生不必要的麻烦,我们最好给$后面的那个特定字符都加上圆括号,比如, ``$(<)`` 就要比 ``$<`` 要好一些。
还得要注意的是,这些变量只使用在规则的命令中,而且一般都是“显式规则”和“静态模式规则”(参见前面“书写规则”一章)。其在隐含规则中并没有意义。
模式的匹配
~~~~~~~~~~
一般来说,一个目标的模式有一个有前缀或是后缀的“%”,或是没有前后缀,直接就是一个“%”。因为“%”代表一个或多个字符,所以在定义好了的模式中,我们把“%”所匹配的内容叫做“茎”,例如“%.c”所匹配的文件“test.c”中“test”就是“茎”。因为在目标和依赖目标中同时有“%”时,依赖目标的“茎”会传给目标,当做目标中的“茎”。
一般来说,一个目标的模式有一个有前缀或是后缀的 ``%`` ,或是没有前后缀,直接就是一个 ``%`` 。因为 ``%`` 代表一个或多个字符,所以在定义好了的模式中,我们把 ``%`` 所匹配的内容叫做“茎”,例如 ``%.c`` 所匹配的文件“test.c”中“test”就是“茎”。因为在目标和依赖目标中同时有 ``%`` 时,依赖目标的“茎”会传给目标,当做目标中的“茎”。
当一个模式匹配包含有斜杠(实际也不经常包含)的文件时,那么在进行模式匹配时,目录部分会首先被移开,然后进行匹配,成功后,再把目录加回去。在进行“茎”的传递时,我们需要知道这个步骤。例如有一个模式“e%t”文件“src/eat匹配于该模式,于是“src/a”就是其“茎”,如果这个模式定义在依赖目标中,而被依赖于这个模式的目标中又有个模式“c%r”,那么,目标就是src/car。(“茎”被传递)
当一个模式匹配包含有斜杠(实际也不经常包含)的文件时,那么在进行模式匹配时,目录部分会首先被移开,然后进行匹配,成功后,再把目录加回去。在进行“茎”的传递时,我们需要知道这个步骤。例如有一个模式 ``e%t`` ,文件 ``src/eat`` 匹配于该模式,于是 ``src/a`` 就是其“茎”,如果这个模式定义在依赖目标中,而被依赖于这个模式的目标中又有个模式 ``c%r`` ,那么,目标就是 ``src/car`` 。(“茎”被传递)
重载内建隐含规则
~~~~~~~~~~~~~~~~
@@ -321,9 +321,9 @@ Make会优化一些特殊的隐含规则而不生成中间文件。如
后缀规则是一个比较老式的定义隐含规则的方法。后缀规则会被模式规则逐步地取代。因为模式规则更强更清晰。为了和老版本的Makefile兼容GNU make同样兼容于这些东西。后缀规则有两种方式“双后缀”和“单后缀”。
双后缀规则定义了一对后缀:目标文件的后缀和依赖目标(源文件)的后缀。如“.c.o”相当于“%o : %c。单后缀规则只定义一个后缀,也就是源文件的后缀。如“.c”相当于“% : %.c
双后缀规则定义了一对后缀:目标文件的后缀和依赖目标(源文件)的后缀。如 ``.c.o`` 相当于 ``%o : %c`` 。单后缀规则只定义一个后缀,也就是源文件的后缀。如 ``.c`` 相当于 ``% : %.c``
后缀规则中所定义的后缀应该是make所认识的如果一个后缀是make所认识的那么这个规则就是单后缀规则而如果两个连在一起的后缀都被make所认识那就是双后缀规则。例如“.c”和“.o”都是make所知道。因而如果你定义了一个规则是“.c.o”那么其就是双后缀规则意义就是“.c”是源文件的后缀“.o”是目标文件的后缀。如下示例:
后缀规则中所定义的后缀应该是make所认识的如果一个后缀是make所认识的那么这个规则就是单后缀规则而如果两个连在一起的后缀都被make所认识那就是双后缀规则。例如 ``.c````.o`` 都是make所知道。因而如果你定义了一个规则是 ``.c.o`` 那么其就是双后缀规则,意义就是 ``.c`` 是源文件的后缀, ``.o`` 是目标文件的后缀。如下示例:
.. code-block:: makefile
@@ -337,7 +337,7 @@ Make会优化一些特殊的隐含规则而不生成中间文件。如
.c.o: foo.h
$(CC) -c $(CFLAGS) $(CPPFLAGS) -o $@ $<
这个例子,就是说,文件“.c.o”依赖于文件“foo.h”,而不是我们想要的这样:
这个例子,就是说,文件 ``.c.o`` 依赖于文件 ``foo.h`` ,而不是我们想要的这样:
.. code-block:: makefile
@@ -346,13 +346,13 @@ Make会优化一些特殊的隐含规则而不生成中间文件。如
后缀规则中,如果没有命令,那是毫无意义的。因为他也不会移去内建的隐含规则。
而要让make知道一些特定的后缀我们可以使用伪目标.SUFFIXES来定义或是删除,如:
而要让make知道一些特定的后缀我们可以使用伪目标 ``.SUFFIXES`` 来定义或是删除,如:
.. code-block:: makefile
.SUFFIXES: .hack .win
把后缀.hack和.win加入后缀列表中的末尾。
把后缀 ``.hack````.win`` 加入后缀列表中的末尾。
.. code-block:: makefile
@@ -361,21 +361,21 @@ Make会优化一些特殊的隐含规则而不生成中间文件。如
先清楚默认后缀,后定义自己的后缀列表。
make的参数“-r”或“-no-builtin-rules也会使用得默认的后缀列表为空。而变量SUFFIXE被用来定义默认的后缀列表,你可以用.SUFFIXES来改变后缀列表,但请不要改变变量SUFFIXE的值。
make的参数 ``-r````-no-builtin-rules`` 也会使用得默认的后缀列表为空。而变量 ``SUFFIXE`` 被用来定义默认的后缀列表,你可以用 ``.SUFFIXES`` 来改变后缀列表,但请不要改变变量 ``SUFFIXE`` 的值。
隐含规则搜索算法
----------------
比如我们有一个目标叫 T。下面是搜索目标T的规则的算法。请注意在下面我们没有提到后缀规则原因是所有的后缀规则在Makefile被载入内存时会被转换成模式规则。如果目标是archive(member)的函数库文件模式那么这个算法会被运行两次第一次是找目标T如果没有找到的话那么进入第二次第二次会把“member”当作T来搜索。
比如我们有一个目标叫 T。下面是搜索目标T的规则的算法。请注意在下面我们没有提到后缀规则原因是所有的后缀规则在Makefile被载入内存时会被转换成模式规则。如果目标是 ``archive(member)`` 的函数库文件模式那么这个算法会被运行两次第一次是找目标T如果没有找到的话那么进入第二次第二次会把 ``member`` 当作T来搜索。
#. 把T的目录部分分离出来。叫D而剩余部分叫N。如果T是src/foo.o那么D就是“src/”N就是“foo.o”
#. 把T的目录部分分离出来。叫D而剩余部分叫N。如果T是 ``src/foo.o`` 那么D就是 ``src/`` N就是 ``foo.o``
#. 创建所有匹配于T或是N的模式规则列表。
#. 如果在模式规则列表中有匹配所有文件的模式,如“%”,那么从列表中移除其它的模式。
#. 如果在模式规则列表中有匹配所有文件的模式,如 ``%`` ,那么从列表中移除其它的模式。
#. 移除列表中没有命令的规则。
#. 对于第一个在列表中的模式规则:
#. 推导其“茎”SS应该是T或是N匹配于模式中“%”非空的部分。
#. 计算依赖文件。把依赖文件中的“%”都替换成“茎”S。如果目标模式中没有包含斜框字符而把D加在第一个依赖文件的开头。
#. 推导其“茎”SS应该是T或是N匹配于模式中 ``%`` 非空的部分。
#. 计算依赖文件。把依赖文件中的 ``%`` 都替换成“茎”S。如果目标模式中没有包含斜框字符而把D加在第一个依赖文件的开头。
#. 测试是否所有的依赖文件都存在或是理当存在。(如果有一个文件被定义成另外一个规则的目标文件,或者是一个显式规则
的依赖文件,那么这个文件就叫“理当存在”)
#. 如果所有的依赖文件存在或是理当存在,或是就没有依赖文件。那么这条规则将被采用,退出该算法。
@@ -389,6 +389,6 @@ make的参数“-r”或“-no-builtin-rules”也会使用得默认的后缀列
#. 如果所有的依赖文件存在或是理当存在,或是就根本没有依赖文件。那么这条规则被采用,退出该算法。
#. 如果没有隐含规则可以使用,查看.DEFAULT规则,如果有,采用,把.DEFAULT的命令给T使用。
#. 如果没有隐含规则可以使用,查看 ``.DEFAULT`` 规则,如果有,采用,把 ``.DEFAULT`` 的命令给T使用。
一旦规则被找到,就会执行其相当的命令,而此时,我们的自动化变量的值才会生成。