diff --git a/source/implicit_rules.rst b/source/implicit_rules.rst index 49f5385..2698329 100644 --- a/source/implicit_rules.rst +++ b/source/implicit_rules.rst @@ -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 ; ; -其含义是，指出了怎么从所有的 ``.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 .y”执行，然后生成“.tab.c”和“.tab.h”文件。（其中，“”表示一个任意字符串）。如果我们的执行程序“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 .y`` 执行，然后生成 ``.tab.c`` 和 ``.tab.h`` 文件。（其中， ```` 表示一个任意字符串）。如果我们的执行程序 ``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`` 中包含了不同的目录很有用。 ``$(;`` 可以用一个或多个空格隔开。举个例子，你有这样几个Makefile：a.mk、b.mk、c.mk，还有一个文件叫foo.make，以及一个变量$(bar)，其包含了e.mk和f.mk，那么，下面的语句： +在include前面可以有一些空字符，但是绝不能是 ``Tab`` 键开始。 ``include`` 和 ``;`` 可以用一个或多个空格隔开。举个例子，你有这样几个Makefile：a.mk、b.mk、c.mk，还有一个文件叫foo.make，以及一个变量 ``$(bar)`` ，其包含了 ``e.mk`` 和 ``f.mk`` ，那么，下面的语句： .. code-block:: makefile @@ -272,7 +272,7 @@ filename可以是当前操作系统Shell的文件模式（可以包含路径和 make命令开始时，会找寻include所指出的其它Makefile，并把其内容安置在当前的位置。就好像C/C++的#include指令一样。如果文件都没有指定绝对路径或是相对路径的话，make会在当前目录下首先寻找，如果当前目录下没有找到，那么，make还会在下面的几个目录下找： -#. 如果make执行时，有“ ``-I`` ”或“ ``--include-dir`` ”参数，那么make就会在这个参数所指定的目录下去寻找。 +#. 如果make执行时，有 ``-I`` 或 ``--include-dir`` 参数，那么make就会在这个参数所指定的目录下去寻找。 #. 如果目录/include（一般是：/usr/local/bin或/usr/include）存在的话，make也会去找。 如果有文件没有找到的话，make会生成一条警告信息，但不会马上出现致命错误。它会继续载入其它的文件，一旦完成makefile的读取，make会再重试这些没有找到，或是不能读取的文件，如果还是不行，make才会出现一条致命信息。如果你想让make不理那些无法读取的文件，而继续执行，你可以在include前加一个减号“-”。如： diff --git a/source/invoke.rst b/source/invoke.rst index 0365b97..38def2f 100644 --- a/source/invoke.rst +++ b/source/invoke.rst @@ -8,10 +8,10 @@ make的退出码 make命令执行后有三个退出码： -0 +0 表示成功执行。 -1 +1 如果make运行时出现任何错误，其返回1。 2 @@ -25,22 +25,22 @@ Make的相关参数我们会在后续章节中讲述。 前面我们说过，GNU make找寻默认的Makefile的规则是在当前目录下依次找三个文件——“GNUmakefile”、“makefile”和“Makefile”。其按顺序找这三个文件，一旦找到，就开始读取这个文件并执行。 -当前，我们也可以给make命令指定一个特殊名字的Makefile。要达到这个功能，我们要使用make的“-f”或是“--file”参数（“--makefile”参数也行）。例如，我们有个makefile的名字是“hchen.mk”，那么，我们可以这样来让make来执行这个文件： +当前，我们也可以给make命令指定一个特殊名字的Makefile。要达到这个功能，我们要使用make的 ``-f`` 或是 ``--file`` 参数（ ``--makefile`` 参数也行）。例如，我们有个makefile的名字是“hchen.mk”，那么，我们可以这样来让make来执行这个文件： :: make –f hchen.mk -如果在make的命令行是，你不只一次地使用了“-f”参数，那么，所有指定的makefile将会被连在一起传递给make执行。 +如果在make的命令行是，你不只一次地使用了 ``-f`` 参数，那么，所有指定的makefile将会被连在一起传递给make执行。 指定目标 -------- 一般来说，make的最终目标是makefile中的第一个目标，而其它目标一般是由这个目标连带出来的。这是make的默认行为。当然，一般来说，你的makefile中的第一个目标是由许多个目标组成，你可以指示make，让其完成你所指定的目标。要达到这一目的很简单，需在make命令后直接跟目标的名字就可以完成（如前面提到的“make clean”形式） -任何在makefile中的目标都可以被指定成终极目标，但是除了以“-”打头，或是包含了“=”的目标，因为有这些字符的目标，会被解析成命令行参数或是变量。甚至没有被我们明确写出来的目标也可以成为make的终极目标，也就是说，只要make可以找到其隐含规则推导规则，那么这个隐含目标同样可以被指定成终极目标。 +任何在makefile中的目标都可以被指定成终极目标，但是除了以 ``-`` 打头，或是包含了 ``=`` 的目标，因为有这些字符的目标，会被解析成命令行参数或是变量。甚至没有被我们明确写出来的目标也可以成为make的终极目标，也就是说，只要make可以找到其隐含规则推导规则，那么这个隐含目标同样可以被指定成终极目标。 -有一个make的环境变量叫“MAKECMDGOALS”，这个变量中会存放你所指定的终极目标的列表，如果在命令行上，你没有指定目标，那么，这个变量是空值。这个变量可以让你使用在一些比较特殊的情形下。比如下面的例子： +有一个make的环境变量叫 ``MAKECMDGOALS`` ，这个变量中会存放你所指定的终极目标的列表，如果在命令行上，你没有指定目标，那么，这个变量是空值。这个变量可以让你使用在一些比较特殊的情形下。比如下面的例子： .. code-block:: makefile @@ -90,7 +90,7 @@ Make的相关参数我们会在后续章节中讲述。 ``-W ``, ``--what-if=``, ``--assume-new=``, ``--new-file=`` 这个参数需要指定一个文件。一般是是源文件（或依赖文件），Make会根据规则推导来运行依赖于这个文件的命令，一般来说，可以和“-n”参数一同使用，来查看这个依赖文件所发生的规则命令。 -另外一个很有意思的用法是结合“-p”和“-v”来输出makefile被执行时的信息（这个将在后面讲述）。 +另外一个很有意思的用法是结合 ``-p`` 和 ``-v`` 来输出makefile被执行时的信息（这个将在后面讲述）。 make的参数 ---------- diff --git a/source/recipes.rst b/source/recipes.rst index 30c1b2b..f3fa474 100644 --- a/source/recipes.rst +++ b/source/recipes.rst @@ -1,14 +1,14 @@ 书写命令 ======== -每条规则中的命令和操作系统Shell的命令行是一致的。make会一按顺序一条一条的执行命令，每条命令的开头必须以[Tab]键开头，除非，命令是紧跟在依赖规则后面的分号后的。在命令行之间中的空格或是空行会被忽略，但是如果该空格或空行是以Tab键开头的，那么make会认为其是一个空命令。 +每条规则中的命令和操作系统Shell的命令行是一致的。make会一按顺序一条一条的执行命令，每条命令的开头必须以 ``Tab`` 键开头，除非，命令是紧跟在依赖规则后面的分号后的。在命令行之间中的空格或是空行会被忽略，但是如果该空格或空行是以Tab键开头的，那么make会认为其是一个空命令。 -我们在UNIX下可能会使用不同的Shell，但是make的命令默认是被“/bin/sh”——UNIX的标准Shell解释执行的。除非你特别指定一个其它的Shell。Makefile中，“#”是注释符，很像C/C++中的“//”，其后的本行字符都被注释。 +我们在UNIX下可能会使用不同的Shell，但是make的命令默认是被 ``/bin/sh`` ——UNIX的标准Shell解释执行的。除非你特别指定一个其它的Shell。Makefile中， ``#`` 是注释符，很像C/C++中的 ``//`` ，其后的本行字符都被注释。 显示命令 -------- -通常，make会把其要执行的命令行在命令执行前输出到屏幕上。当我们用“@”字符在命令行前，那么，这个命令将不被make显示出来，最具代表性的例子是，我们用这个功能来向屏幕显示一些信息。如:: +通常，make会把其要执行的命令行在命令执行前输出到屏幕上。当我们用 ``@`` 字符在命令行前，那么，这个命令将不被make显示出来，最具代表性的例子是，我们用这个功能来向屏幕显示一些信息。如:: @echo 正在编译XXX模块...... @@ -17,9 +17,9 @@ echo 正在编译XXX模块...... 正在编译XXX模块...... -如果make执行时，带入make参数“-n”或“--just-print”，那么其只是显示命令，但不会执行命令，这个功能很有利于我们调试我们的Makefile，看看我们书写的命令是执行起来是什么样子的或是什么顺序的。 +如果make执行时，带入make参数 ``-n`` 或 ``--just-print`` ，那么其只是显示命令，但不会执行命令，这个功能很有利于我们调试我们的Makefile，看看我们书写的命令是执行起来是什么样子的或是什么顺序的。 -而make参数“-s”或“--slient”则是全面禁止命令的显示。 +而make参数 ``-s`` 或 ``--slient`` 则是全面禁止命令的显示。 命令执行 -------- @@ -41,9 +41,9 @@ exec: cd /home/hchen; pwd -当我们执行“make exec”时，第一个例子中的cd没有作用，pwd会打印出当前的Makefile目录，而第二个例子中，cd就起作用了，pwd会打印出“/home/hchen”。 +当我们执行 ``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一般是使用环境变量SHELL中所定义的系统Shell来执行命令，默认情况下使用UNIX的标准Shell——/bin/sh来执行命令。但在MS-DOS下有点特殊，因为MS-DOS下没有SHELL环境变量，当然你也可以指定。如果你指定了UNIX风格的目录形式，首先，make会在SHELL所指定的路径中找寻命令解释器，如果找不到，其会在当前盘符中的当前目录中寻找，如果再找不到，其会在PATH环境变量中所定义的所有路径中寻找。MS-DOS中，如果你定义的命令解释器没有找到，其会给你的命令解释器加上诸如 ``.exe`` 、 ``.com`` 、 ``.bat`` 、 ``.sh`` 等后缀。 命令出错 -------- @@ -52,16 +52,16 @@ make一般是使用环境变量SHELL中所定义的系统Shell来执行命令， 有些时候，命令的出错并不表示就是错误的。例如mkdir命令，我们一定需要建立一个目录，如果目录不存在，那么mkdir就成功执行，万事大吉，如果目录存在，那么就出错了。我们之所以使用mkdir的意思就是一定要有这样的一个目录，于是我们就不希望mkdir出错而终止规则的运行。 -为了做到这一点，忽略命令的出错，我们可以在Makefile的命令行前加一个减号“-”（在Tab键之后），标记为不管命令出不出错都认为是成功的。如： +为了做到这一点，忽略命令的出错，我们可以在Makefile的命令行前加一个减号 ``-`` （在Tab键之后），标记为不管命令出不出错都认为是成功的。如： .. code-block:: bash clean: -rm -f *.o -还有一个全局的办法是，给make加上“-i”或是“--ignore-errors”参数，那么，Makefile中所有命令都会忽略错误。而如果一个规则是以“.IGNORE”作为目标的，那么这个规则中的所有命令将会忽略错误。这些是不同级别的防止命令出错的方法，你可以根据你的不同喜欢设置。 +还有一个全局的办法是，给make加上 ``-i`` 或是 ``--ignore-errors`` 参数，那么，Makefile中所有命令都会忽略错误。而如果一个规则是以 ``.IGNORE`` 作为目标的，那么这个规则中的所有命令将会忽略错误。这些是不同级别的防止命令出错的方法，你可以根据你的不同喜欢设置。 -还有一个要提一下的make的参数的是“-k”或是“--keep-going”，这个参数的意思是，如果某规则中的命令出错了，那么就终目该规则的执行，但继续执行其它规则。 +还有一个要提一下的make的参数的是 ``-k`` 或是 ``--keep-going`` ，这个参数的意思是，如果某规则中的命令出错了，那么就终目该规则的执行，但继续执行其它规则。 嵌套执行make ------------ @@ -84,7 +84,7 @@ make一般是使用环境变量SHELL中所定义的系统Shell来执行命令， 定义$(MAKE)宏变量的意思是，也许我们的make需要一些参数，所以定义成一个变量比较利于维护。这两个例子的意思都是先进入“subdir”目录，然后执行make命令。 -我们把这个Makefile叫做“总控Makefile”，总控Makefile的变量可以传递到下级的Makefile中（如果你显示的声明），但是不会覆盖下层的Makefile中所定义的变量，除非指定了“-e”参数。 +我们把这个Makefile叫做“总控Makefile”，总控Makefile的变量可以传递到下级的Makefile中（如果你显示的声明），但是不会覆盖下层的Makefile中所定义的变量，除非指定了 ``-e`` 参数。 如果你要传递变量到下级Makefile中，那么你可以使用这样的声明： @@ -92,10 +92,10 @@ make一般是使用环境变量SHELL中所定义的系统Shell来执行命令， export ; -如果你不想让某些变量传递到下级Makefile中，那么你可以这样声明： +如果你不想让某些变量传递到下级Makefile中，那么你可以这样声明： .. code-block:: makefile - + unexport ; 如： @@ -135,24 +135,24 @@ make一般是使用环境变量SHELL中所定义的系统Shell来执行命令， 其等价于： .. code-block:: makefile - + variable += value export variable 如果你要传递所有的变量，那么，只要一个export就行了。后面什么也不用跟，表示传递所有的变量。 -需要注意的是，有两个变量，一个是SHELL，一个是MAKEFLAGS，这两个变量不管你是否export，其总是要传递到下层 Makefile中，特别是MAKEFILES变量，其中包含了make的参数信息，如果我们执行“总控Makefile”时有make参数或是在上层 Makefile中定义了这个变量，那么MAKEFILES变量将会是这些参数，并会传递到下层Makefile中，这是一个系统级的环境变量。 +需要注意的是，有两个变量，一个是 ``SHELL`` ，一个是 ``MAKEFLAGS`` ，这两个变量不管你是否export，其总是要传递到下层 Makefile中，特别是 ``MAKEFILES`` 变量，其中包含了make的参数信息，如果我们执行“总控Makefile”时有make参数或是在上层 Makefile中定义了这个变量，那么 ``MAKEFILES`` 变量将会是这些参数，并会传递到下层Makefile中，这是一个系统级的环境变量。 + +但是make命令中的有几个参数并不往下传递，它们是 ``-C`` , ``-f`` , ``-h``, ``-o`` 和 ``-W`` （有关Makefile参数的细节将在后面说明），如果你不想往下层传递参数，那么，你可以这样来： -但是make命令中的有几个参数并不往下传递，它们是“-C”,“-f”,“-h”“-o”和“-W”（有关Makefile参数的细节将在后面说明），如果你不想往下层传递参数，那么，你可以这样来： - .. code-block:: makefile subsystem: cd subdir && $(MAKE) MAKEFLAGS= -如果你定义了环境变量MAKEFLAGS，那么你得确信其中的选项是大家都会用到的，如果其中有“-t”,“-n”,和“-q”参数，那么将会有让你意想不到的结果，或许会让你异常地恐慌。 +如果你定义了环境变量 ``MAKEFLAGS`` ，那么你得确信其中的选项是大家都会用到的，如果其中有 ``-t`` , ``-n`` 和 ``-q`` 参数，那么将会有让你意想不到的结果，或许会让你异常地恐慌。 -还有一个在“嵌套执行”中比较有用的参数，“-w”或是“--print-directory”会在make的过程中输出一些信息，让你看到目前的工作目录。比如，如果我们的下级make目录是“/home/hchen/gnu/make”，如果我们使用“make -w”来执行，那么当进入该目录时，我们会看到:: +还有一个在“嵌套执行”中比较有用的参数， ``-w`` 或是 ``--print-directory`` 会在make的过程中输出一些信息，让你看到目前的工作目录。比如，如果我们的下级make目录是“/home/hchen/gnu/make”，如果我们使用 ``make -w`` 来执行，那么当进入该目录时，我们会看到:: make: Entering directory `/home/hchen/gnu/make'. @@ -160,12 +160,12 @@ make一般是使用环境变量SHELL中所定义的系统Shell来执行命令， make: Leaving directory `/home/hchen/gnu/make' -当你使用“-C”参数来指定make下层Makefile时，“-w”会被自动打开的。如果参数中有“-s”（“--slient”）或是“--no-print-directory”，那么，“-w”总是失效的。 +当你使用 ``-C`` 参数来指定make下层Makefile时， ``-w`` 会被自动打开的。如果参数中有 ``-s`` （ ``--slient`` ）或是 ``--no-print-directory`` ，那么， ``-w`` 总是失效的。 定义命令包 ---------- -如果Makefile中出现一些相同命令序列，那么我们可以为这些相同的命令序列定义一个变量。定义这种命令序列的语法以“define”开始，以“endef”结束，如： +如果Makefile中出现一些相同命令序列，那么我们可以为这些相同的命令序列定义一个变量。定义这种命令序列的语法以 ``define`` 开始，以 ``endef`` 结束，如： .. code-block:: makefile @@ -174,11 +174,11 @@ make一般是使用环境变量SHELL中所定义的系统Shell来执行命令， mv y.tab.c $@ endef -这里，“run-yacc”是这个命令包的名字，其不要和Makefile中的变量重名。在“define”和“endef”中的两行就是命令序列。这个命令包中的第一个命令是运行Yacc程序，因为Yacc程序总是生成“y.tab.c”的文件，所以第二行的命令就是把这个文件改改名字。还是把这个命令包放到一个示例中来看看吧。 +这里，“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在执行命令包时，命令包中的每个命令会被依次独立执行。 +我们可以看见，要使用这个命令包，我们就好像使用变量一样。在这个命令包的使用中，命令包“run-yacc”中的 ``$^`` 就是 ``foo.y`` ， ``$@`` 就是 ``foo.c`` （有关这种以 ``$`` 开头的特殊变量，我们会在后面介绍），make在执行命令包时，命令包中的每个命令会被依次独立执行。 diff --git a/source/rules.rst b/source/rules.rst index a31157e..1b06735 100644 --- a/source/rules.rst +++ b/source/rules.rst @@ -16,10 +16,10 @@ 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`` 是目标所依赖的源文件，而只有一个命令 ``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文件） +#. 文件的依赖关系， ``foo.o`` 依赖于 ``foo.c`` 和 ``defs.h`` 的文件，如果 ``foo.c`` 和 ``defs.h`` 的文件日期要比 ``foo.o`` 文件日期要新，或是 ``foo.o`` 不存在，那么依赖关系发生。 +#. 生成或更新 ``foo.o`` 文件，就是那个cc命令。它说明了如何生成 ``foo.o`` 这个文件。（当然，foo.c文件include了defs.h文件） 规则的语法 ---------- @@ -40,20 +40,20 @@ targets是文件名，以空格分开，可以使用通配符。一般来说，我们的目标基本上是一个文件，但也有可能是多个文件。 -command是命令行，如果其不与“target:prerequisites”在一行，那么，必须以[Tab键]开头，如果和prerequisites在一行，那么可以用分号做为分隔。（见上） +command是命令行，如果其不与“target:prerequisites”在一行，那么，必须以 ``Tab`` 键开头，如果和prerequisites在一行，那么可以用分号做为分隔。（见上） prerequisites也就是目标所依赖的文件（或依赖目标）。如果其中的某个文件要比目标文件要新，那么，目标就被认为是“过时的”，被认为是需要重生成的。这个在前面已经讲过了。 -如果命令太长，你可以使用反斜框（‘\\’）作为换行符。make对一行上有多少个字符没有限制。规则告诉make两件事，文件的依赖关系和如何生成目标文件。 +如果命令太长，你可以使用反斜框（ ``\`` ）作为换行符。make对一行上有多少个字符没有限制。规则告诉make两件事，文件的依赖关系和如何生成目标文件。 -一般来说，make会以UNIX的标准Shell，也就是\ ``/bin/sh``\ 来执行命令。 +一般来说，make会以UNIX的标准Shell，也就是 ``/bin/sh`` 来执行命令。 在规则中使用通配符 ------------------ -如果我们想定义一系列比较类似的文件，我们很自然地就想起使用通配符。make支持三个通配符：“*”，“?”和“~”。这是和Unix的B-Shell是相同的。 +如果我们想定义一系列比较类似的文件，我们很自然地就想起使用通配符。make支持三个通配符： ``*`` ， ``?`` 和 ``~`` 。这是和Unix的B-Shell是相同的。 -波浪号（“~”）字符在文件名中也有比较特殊的用途。如果是“~/test”，这就表示当前用户的$HOME目录下的test目录。而 “~hchen/test”则表示用户hchen的宿主目录下的test目录。（这些都是Unix下的小知识了，make也支持）而在Windows或是 MS-DOS下，用户没有宿主目录，那么波浪号所指的目录则根据环境变量“HOME”而定。 +波浪号（ ``~`` ）字符在文件名中也有比较特殊的用途。如果是 ``~/test`` ，这就表示当前用户的$HOME目录下的test目录。而 ``~hchen/test`` 则表示用户hchen的宿主目录下的test目录。（这些都是Unix下的小知识了，make也支持）而在Windows或是 MS-DOS下，用户没有宿主目录，那么波浪号所指的目录则根据环境变量“HOME”而定。 通配符代替了你一系列的文件，如 ``*.c`` 表示所有后缀为c的文件。一个需要我们注意的是，如果我们的文件名中有通配符，如： ``*`` ，那么可以用转义字符 ``\`` ，如 ``\*`` 来表示真实的 ``*`` 字符，而不是任意长度的字符串。 @@ -80,13 +80,13 @@ prerequisites也就是目标所依赖的文件（或依赖目标）。如果其 lpr -p $? touch print -上面这个例子说明了通配符也可以在我们的规则中，目标print依赖于所有的[.c]文件。其中的“$?”是一个自动化变量，我会在后面给你讲述。 +上面这个例子说明了通配符也可以在我们的规则中，目标print依赖于所有的 ``.c`` 文件。其中的 ``$?`` 是一个自动化变量，我会在后面给你讲述。 .. code-block:: makefile objects = *.o -上面这个例子，表示了通配符同样可以用在变量中。并不是说\ ``*.o``\ 会展开，不！objects的值就是\ ``*.o``\ 。Makefile中的变量其实就是C/C++中的宏。如果你要让通配符在变量中展开，也就是让objects的值是所有[.o]的文件名的集合，那么，你可以这样： +上面这个例子，表示了通配符同样可以用在变量中。并不是说 ``*.o`` 会展开，不！objects的值就是 ``*.o`` 。Makefile中的变量其实就是C/C++中的宏。如果你要让通配符在变量中展开，也就是让objects的值是所有 ``.o`` 的文件名的集合，那么，你可以这样： .. code-block:: makefile @@ -94,19 +94,19 @@ prerequisites也就是目标所依赖的文件（或依赖目标）。如果其 另给一个变量使用通配符的例子： -#. 列出一确定文件夹中的所有“.c”文件。 +#. 列出一确定文件夹中的所有 ``.c`` 文件。 .. code-block:: makefile objects := $(wildcard *.c) -#. 列出(1)中所有文件对应的“.o”文件，在（3）中我们可以看到它是由make自动编译出的。 +#. 列出(1)中所有文件对应的 ``.o`` 文件，在（3）中我们可以看到它是由make自动编译出的。 .. code-block:: makefile $(patsubst %.c,%.o,$(wildcard *.c)) -#. 由(1)(2)两步，可写出编译并链接所有“.c”和”.o“文件 +#. 由(1)(2)两步，可写出编译并链接所有 ``.c`` 和 ``.o`` 文件 .. code-block:: makefile @@ -121,7 +121,7 @@ prerequisites也就是目标所依赖的文件（或依赖目标）。如果其 在一些大的工程中，有大量的源文件，我们通常的做法是把这许多的源文件分类，并存放在不同的目录中。所以，当make需要去找寻文件的依赖关系时，你可以在文件前加上路径，但最好的方法是把一个路径告诉make，让make在自动去找。 -Makefile文件中的特殊变量“VPATH”就是完成这个功能的，如果没有指明这个变量，make只会在当前的目录中去找寻依赖文件和目标文件。如果定义了这个变量，那么，make就会在当当前目录找不到的情况下，到所指定的目录中去找寻文件了。 +Makefile文件中的特殊变量 ``VPATH`` 就是完成这个功能的，如果没有指明这个变量，make只会在当前的目录中去找寻依赖文件和目标文件。如果定义了这个变量，那么，make就会在当当前目录找不到的情况下，到所指定的目录中去找寻文件了。 .. code-block:: makefile @@ -131,22 +131,22 @@ Makefile文件中的特殊变量“VPATH”就是完成这个功能的，如果 另一个设置文件搜索路径的方法是使用make的“vpath”关键字（注意，它是全小写的），这不是变量，这是一个make的关键字，这和上面提到的那个VPATH变量很类似，但是它更为灵活。它可以指定不同的文件在不同的搜索目录中。这是一个很灵活的功能。它的使用方法有三种： -\ ``vpath ``\ +``vpath `` 为符合模式的文件指定搜索目录。 -\ ``vpath ``\ +``vpath `` 清除符合模式的文件的搜索目录。 -\ ``vpath``\ +``vpath`` 清除所有已被设置好了的文件搜索目录。 -vapth使用方法中的需要包含“%”字符。“%”的意思是匹配零或若干字符，（需引用“%”，使用“\\%”）例如，“%.h”表示所有以 “.h”结尾的文件。指定了要搜索的文件集，而则指定了< pattern>的文件集的搜索的目录。例如： +vapth使用方法中的需要包含 ``%`` 字符。 ``%`` 的意思是匹配零或若干字符，（需引用 ``%`` ，使用 ``\`` ）例如， ``%.h`` 表示所有以 ``.h`` 结尾的文件。指定了要搜索的文件集，而则指定了< pattern>的文件集的搜索的目录。例如： .. code-block:: makefile vpath %.h ../headers -该语句表示，要求make在“../headers”目录下搜索所有以“.h”结尾的文件。（如果某文件在当前目录没有找到的话） +该语句表示，要求make在“../headers”目录下搜索所有以 ``.h`` 结尾的文件。（如果某文件在当前目录没有找到的话） 我们可以连续地使用vpath语句，以指定不同搜索策略。如果连续的vpath语句中出现了相同的，或是被重复了的，那么，make会按照vpath语句的先后顺序来执行搜索。如： @@ -156,14 +156,14 @@ vapth使用方法中的需要包含“%”字符。“%”的意思是 vpath % blish vpath %.c bar -其表示“.c”结尾的文件，先在“foo”目录，然后是“blish”，最后是“bar”目录。 +其表示 ``.c`` 结尾的文件，先在“foo”目录，然后是“blish”，最后是“bar”目录。 .. code-block:: makefile vpath %.c foo:bar vpath % blish -而上面的语句则表示“.c”结尾的文件，先在“foo”目录，然后是“bar”目录，最后才是“blish”目录。 +而上面的语句则表示 ``.c`` 结尾的文件，先在“foo”目录，然后是“bar”目录，最后才是“blish”目录。 伪目标 ------ @@ -209,7 +209,7 @@ vapth使用方法中的需要包含“%”字符。“%”的意思是 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”文件，而执行后面的多个目标。建议：显式写出是一个好习惯。） +我们知道，Makefile中的第一个目标会被作为其默认目标。我们声明了一个“all”的伪目标，其依赖于其它三个目标。由于默认目标的特性是，总是被执行的，但由于“all”又是一个伪目标，伪目标只是一个标签不会生成文件，所以不会有“all”文件产生。于是，其它三个目标的规则总是会被决议。也就达到了我们一口气生成多个目标的目的。 ``.PHONY : all`` 声明了“all”这个目标为“伪目标”。（注：这里的显式 “.PHONY : all” 不写的话一般情况也可以正确的执行，这样make可通过隐式规则推导出， “all” 是一个伪目标，执行make不会生成“all”文件，而执行后面的多个目标。建议：显式写出是一个好习惯。） 随便提一句，从上面的例子我们可以看出，目标也可以成为依赖。所以，伪目标同样也可成为依赖。看下面的例子： @@ -231,7 +231,7 @@ vapth使用方法中的需要包含“%”字符。“%”的意思是 多目标 ------ -Makefile的规则中的目标可以不止一个，其支持多目标，有可能我们的多个目标同时依赖于一个文件，并且其生成的命令大体类似。于是我们就能把其合并起来。当然，多个目标的生成规则的执行命令不是同一个，这可能会可我们带来麻烦，不过好在我们可以使用一个自动化变量“$@”（关于自动化变量，将在后面讲述），这个变量表示着目前规则中所有的目标的集合，这样说可能很抽象，还是看一个例子吧。 +Makefile的规则中的目标可以不止一个，其支持多目标，有可能我们的多个目标同时依赖于一个文件，并且其生成的命令大体类似。于是我们就能把其合并起来。当然，多个目标的生成规则的执行命令不是同一个，这可能会可我们带来麻烦，不过好在我们可以使用一个自动化变量 ``$@`` （关于自动化变量，将在后面讲述），这个变量表示着目前规则中所有的目标的集合，这样说可能很抽象，还是看一个例子吧。 .. code-block:: makefile @@ -247,7 +247,7 @@ Makefile的规则中的目标可以不止一个，其支持多目标，有可能 littleoutput : text.g generate text.g -little > littleoutput -其中，-$(subst output,,$@)中的“$”表示执行一个Makefile的函数，函数名为subst，后面的为参数。关于函数，将在后面讲述。这里的这个函数是替换字符串的意思，“$@”表示目标的集合，就像一个数组，“$@”依次取出目标，并执于命令。 +其中， ``-$(subst output,,$@)`` 中的 ``$`` 表示执行一个Makefile的函数，函数名为subst，后面的为参数。关于函数，将在后面讲述。这里的这个函数是替换字符串的意思， ``$@`` 表示目标的集合，就像一个数组， ``$@`` 依次取出目标，并执于命令。 静态模式 -------- @@ -266,9 +266,9 @@ target-parrtern是指明了targets的模式，也就是的目标集模式。 prereq-parrterns是目标的依赖模式，它对target-parrtern形成的模式再进行一次依赖目标的定义。 -这样描述这三个东西，可能还是没有说清楚，还是举个例子来说明一下吧。如果我们的定义成“%.o”，意思是我们的;集合中都是以“.o”结尾的，而如果我们的定义成 “%.c”，意思是对所形成的目标集进行二次定义，其计算方法是，取模式中的“%”（也就是去掉了[.o]这个结尾），并为其加上[.c]这个结尾，形成的新集合。 +这样描述这三个东西，可能还是没有说清楚，还是举个例子来说明一下吧。如果我们的定义成 ``%.o`` ，意思是我们的;集合中都是以 ``.o`` 结尾的，而如果我们的定义成 ``%.c`` ，意思是对所形成的目标集进行二次定义，其计算方法是，取模式中的 ``%`` （也就是去掉了 ``.o`` 这个结尾），并为其加上 ``.c`` 这个结尾，形成的新集合。 -所以，我们的“目标模式”或是“依赖模式”中都应该有“%”这个字符，如果你的文件名中有“%”那么你可以使用反斜杠“\\”进行转义，来标明真实的“%”字符。 +所以，我们的“目标模式”或是“依赖模式”中都应该有 ``%`` 这个字符，如果你的文件名中有 ``%`` 那么你可以使用反斜杠 ``\`` 进行转义，来标明真实的 ``%`` 字符。 看一个例子： @@ -281,7 +281,7 @@ prereq-parrterns是目标的依赖模式，它对target-parrtern形成的模式 $(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.c bar.c”），“$@”表示目标集（也就是“foo.o bar.o”）。于是，上面的规则展开后等价于下面的规则： +上面的例子中，指明了我们的目标从$object中获取， ``%.o`` 表明要所有以 ``.o`` 结尾的目标，也就是 ``foo.o bar.o`` ，也就是变量 ``$object`` 集合的模式，而依赖模式 ``%.c`` 则取模式 ``%.o`` 的 ``%`` ，也就是 ``foo bar`` ，并为其加下 ``.c`` 的后缀，于是，我们的依赖目标就是 ``foo.c bar.c`` 。而命令中的 ``$<`` 和 ``$@`` 则是自动化变量， ``$<`` 表示所有的依赖目标集（也就是 ``foo.c bar.c`` ）， ``$@`` 表示目标集（也就是“foo.o bar.o”）。于是，上面的规则展开后等价于下面的规则： .. code-block:: makefile @@ -290,7 +290,7 @@ prereq-parrterns是目标的依赖模式，它对target-parrtern形成的模式 bar.o : bar.c $(CC) -c $(CFLAGS) bar.c -o bar.o -试想，如果我们的“%.o”有几百个，那么我们只要用这种很简单的“静态模式规则”就可以写完一堆规则，实在是太有效率了。“静态模式规则”的用法很灵活，如果用得好，那会一个很强大的功能。再看一个例子： +试想，如果我们的 ``%.o`` 有几百个，那么我们只要用这种很简单的“静态模式规则”就可以写完一堆规则，实在是太有效率了。“静态模式规则”的用法很灵活，如果用得好，那会一个很强大的功能。再看一个例子： .. code-block:: makefile @@ -306,7 +306,7 @@ $(filter %.o,$(files))表示调用Makefile的filter函数，过滤“$files” 自动生成依赖性 -------------- -在Makefile中，我们的依赖关系可能会需要包含一系列的头文件，比如，如果我们的main.c中有一句“#include "defs.h"”，那么我们的依赖关系应该是： +在Makefile中，我们的依赖关系可能会需要包含一系列的头文件，比如，如果我们的main.c中有一句 ``#include "defs.h"`` ，那么我们的依赖关系应该是： .. code-block:: makefile @@ -324,7 +324,7 @@ $(filter %.o,$(files))表示调用Makefile的filter函数，过滤“$files” main.o : main.c defs.h -于是由编译器自动生成的依赖关系，这样一来，你就不必再手动书写若干文件的依赖关系，而由编译器自动生成了。需要提醒一句的是，如果你使用GNU的C/C++编译器，你得用“-MM”参数，不然，“-M”参数会把一些标准库的头文件也包含进来。 +于是由编译器自动生成的依赖关系，这样一来，你就不必再手动书写若干文件的依赖关系，而由编译器自动生成了。需要提醒一句的是，如果你使用GNU的C/C++编译器，你得用 ``-MM`` 参数，不然， ``-M`` 参数会把一些标准库的头文件也包含进来。 gcc -M main.c的输出是:: @@ -342,11 +342,11 @@ gcc -MM main.c的输出则是:: main.o: main.c defs.h -那么，编译器的这个功能如何与我们的Makefile联系在一起呢。因为这样一来，我们的Makefile也要根据这些源文件重新生成，让 Makefile自已依赖于源文件？这个功能并不现实，不过我们可以有其它手段来迂回地实现这一功能。GNU组织建议把编译器为每一个源文件的自动生成的依赖关系放到一个文件中，为每一个“name.c”的文件都生成一个“name.d”的Makefile文件，[.d]文件中就存放对应[.c]文件的依赖关系。 +那么，编译器的这个功能如何与我们的Makefile联系在一起呢。因为这样一来，我们的Makefile也要根据这些源文件重新生成，让 Makefile自已依赖于源文件？这个功能并不现实，不过我们可以有其它手段来迂回地实现这一功能。GNU组织建议把编译器为每一个源文件的自动生成的依赖关系放到一个文件中，为每一个 ``name.c`` 的文件都生成一个 ``name.d`` 的Makefile文件， ``.d`` 文件中就存放对应 ``.c`` 文件的依赖关系。 -于是，我们可以写出[.c]文件和[.d]文件的依赖关系，并让make自动更新或生成[.d]文件，并把其包含在我们的主Makefile中，这样，我们就可以自动化地生成每个文件的依赖关系了。 +于是，我们可以写出 ``.c`` 文件和 ``.d`` 文件的依赖关系，并让make自动更新或生成 ``.d`` 文件，并把其包含在我们的主Makefile中，这样，我们就可以自动化地生成每个文件的依赖关系了。 -这里，我们给出了一个模式规则来产生[.d]文件： +这里，我们给出了一个模式规则来产生 ``.d`` 文件： .. code-block:: makefile @@ -357,9 +357,9 @@ gcc -MM main.c的输出则是:: rm -f $@.$$$$ -这个规则的意思是，所有的[.d]文件依赖于[.c]文件，“rm -f $@”的意思是删除所有的目标，也就是[.d]文件，第二行的意思是，为每个依赖文件“$<”，也就是[.c]文件生成依赖文件，“$@”表示模式“%.d”文件，如果有一个C文件是name.c，那么“%”就是 “name”，“$$$$”意为一个随机编号，第二行生成的文件有可能是“name.d.12345”，第三行使用sed命令做了一个替换，关于sed命令的用法请参看相关的使用文档。第四行就是删除临时文件。 +这个规则的意思是，所有的 ``.d`` 文件依赖于 ``.c`` 文件， ``rm -f $@`` 的意思是删除所有的目标，也就是 ``.d`` 文件，第二行的意思是，为每个依赖文件 ``$<`` ，也就是 ``.c`` 文件生成依赖文件， ``$@`` 表示模式 ``%.d`` 文件，如果有一个C文件是name.c，那么 ``%`` 就是 ``name`` ， ``$$$$`` 意为一个随机编号，第二行生成的文件有可能是“name.d.12345”，第三行使用sed命令做了一个替换，关于sed命令的用法请参看相关的使用文档。第四行就是删除临时文件。 -总而言之，这个模式要做的事就是在编译器生成的依赖关系中加入[.d]文件的依赖，即把依赖关系： +总而言之，这个模式要做的事就是在编译器生成的依赖关系中加入 ``.d`` 文件的依赖，即把依赖关系： .. code-block:: makefile @@ -371,7 +371,7 @@ gcc -MM main.c的输出则是:: main.o main.d : main.c defs.h -于是，我们的[.d]文件也会自动更新了，并会自动生成了，当然，你还可以在这个[.d]文件中加入的不只是依赖关系，包括生成的命令也可一并加入，让每个[.d]文件都包含一个完赖的规则。一旦我们完成这个工作，接下来，我们就要把这些自动生成的规则放进我们的主Makefile中。我们可以使用Makefile的“include”命令，来引入别的Makefile文件（前面讲过），例如： +于是，我们的 ``.d`` 文件也会自动更新了，并会自动生成了，当然，你还可以在这个 ``.d`` 文件中加入的不只是依赖关系，包括生成的命令也可一并加入，让每个 ``.d`` 文件都包含一个完赖的规则。一旦我们完成这个工作，接下来，我们就要把这些自动生成的规则放进我们的主Makefile中。我们可以使用Makefile的“include”命令，来引入别的Makefile文件（前面讲过），例如： .. code-block:: makefile @@ -379,4 +379,4 @@ gcc -MM main.c的输出则是:: include $(sources:.c=.d) -上述语句中的“$(sources:.c=.d)”中的“.c=.d”的意思是做一个替换，把变量$(sources)所有[.c]的字串都替换成[.d]，关于这个“替换”的内容，在后面我会有更为详细的讲述。当然，你得注意次序，因为include是按次来载入文件，最先载入的[.d]文件中的目标会成为默认目标。 +上述语句中的 ``$(sources:.c=.d)`` 中的 ``.c=.d`` 的意思是做一个替换，把变量 ``$(sources)`` 所有 ``.c`` 的字串都替换成 ``.d`` ，关于这个“替换”的内容，在后面我会有更为详细的讲述。当然，你得注意次序，因为include是按次来载入文件，最先载入的 ``.d`` 文件中的目标会成为默认目标。 diff --git a/source/variables.rst b/source/variables.rst index 8d18c26..a124b0f 100644 --- a/source/variables.rst +++ b/source/variables.rst @@ -3,14 +3,14 @@ 在Makefile中的定义的变量，就像是C/C++语言中的宏一样，他代表了一个文本字串，在Makefile中执行的时候其会自动原模原样地展开在所使用的地方。其与C/C++所不同的是，你可以在Makefile中改变其值。在Makefile中，变量可以使用在“目标”，“依赖目标”， “命令”或是Makefile的其它部分中。 -变量的命名字可以包含字符、数字，下划线（可以是数字开头），但不应该含有“:”、“#”、“=”或是空字符（空格、回车等）。变量是大小写敏感的，“foo”、“Foo”和“FOO”是三个不同的变量名。传统的Makefile的变量名是全大写的命名方式，但我推荐使用大小写搭配的变量名，如： MakeFlags。这样可以避免和系统的变量冲突，而发生意外的事情。 +变量的命名字可以包含字符、数字，下划线（可以是数字开头），但不应该含有 ``:`` 、 ``#`` 、 ``=`` 或是空字符（空格、回车等）。变量是大小写敏感的，“foo”、“Foo”和“FOO”是三个不同的变量名。传统的Makefile的变量名是全大写的命名方式，但我推荐使用大小写搭配的变量名，如： MakeFlags。这样可以避免和系统的变量冲突，而发生意外的事情。 -有一些变量是很奇怪字串，如“$<”、“$@”等，这些是自动化变量，我会在后面介绍。 +有一些变量是很奇怪字串，如 ``$<`` 、 ``$@`` 等，这些是自动化变量，我会在后面介绍。 变量的基础 ---------- -变量在声明时需要给予初值，而在使用时，需要给在变量名前加上“$”符号，但最好用小括号“（）”或是大括号“{}”把变量给包括起来。如果你要使用真实的“$”字符，那么你需要用“$$”来表示。 +变量在声明时需要给予初值，而在使用时，需要给在变量名前加上 ``$`` 符号，但最好用小括号 ``()`` 或是大括号 ``{}`` 把变量给包括起来。如果你要使用真实的 ``$`` 字符，那么你需要用 ``$$`` 来表示。 变量可以使用在许多地方，如规则中的“目标”、“依赖”、“命令”以及新的变量中。先看一个例子： @@ -19,11 +19,11 @@ objects = program.o foo.o utils.o program : $(objects) cc -o program $(objects) - + $(objects) : defs.h 变量会在使用它的地方精确地展开，就像C/C++中的宏一样，例如： - + .. code-block:: makefile foo = c @@ -46,18 +46,18 @@ 在定义变量的值时，我们可以使用其它变量来构造变量的值，在Makefile中有两种方式来在用变量定义变量的值。 -先看第一种方式，也就是简单的使用“=”号，在“=”左侧是变量，右侧是变量的值，右侧变量的值可以定义在文件的任何一处，也就是说，右侧中的变量不一定非要是已定义好的值，其也可以使用后面定义的值。如： +先看第一种方式，也就是简单的使用 ``=`` 号，在 ``=`` 左侧是变量，右侧是变量的值，右侧变量的值可以定义在文件的任何一处，也就是说，右侧中的变量不一定非要是已定义好的值，其也可以使用后面定义的值。如： .. code-block:: makefile foo = $(bar) bar = $(ugh) ugh = Huh? - + all: echo $(foo) -我们执行“make all”将会打出变量$(foo)的值是“Huh?”（ $(foo)的值是$(bar)，$(bar)的值是$(ugh)，$(ugh)的值是“Huh?”）可见，变量是可以使用后面的变量来定义的。 +我们执行“make all”将会打出变量 ``$(foo)`` 的值是 ``Huh?`` （ ``$(foo)`` 的值是 ``$(bar)`` ， ``$(bar)`` 的值是 ``$(ugh)`` ， ``$(ugh)`` 的值是 ``Huh?`` ）可见，变量是可以使用后面的变量来定义的。 这个功能有好的地方，也有不好的地方，好的地方是，我们可以把变量的真实值推到后面来定义，如： @@ -66,14 +66,14 @@ CFLAGS = $(include_dirs) -O include_dirs = -Ifoo -Ibar -当“CFLAGS”在命令中被展开时，会是“-Ifoo -Ibar -O”。但这种形式也有不好的地方，那就是递归定义，如： +当 ``CFLAGS`` 在命令中被展开时，会是 ``-Ifoo -Ibar -O`` 。但这种形式也有不好的地方，那就是递归定义，如： .. code-block:: makefile CFLAGS = $(CFLAGS) -O 或： - + .. code-block:: makefile A = $(B) @@ -81,7 +81,7 @@ 这会让make陷入无限的变量展开过程中去，当然，我们的make是有能力检测这样的定义，并会报错。还有就是如果在变量中使用函数，那么，这种方式会让我们的make运行时非常慢，更糟糕的是，他会使用得两个make的函数“wildcard”和“shell”发生不可预知的错误。因为你不会知道这两个函数会被调用多少次。 -为了避免上面的这种方法，我们可以使用make中的另一种用变量来定义变量的方法。这种方法使用的是“:=”操作符，如： +为了避免上面的这种方法，我们可以使用make中的另一种用变量来定义变量的方法。这种方法使用的是 ``:=`` 操作符，如： .. code-block:: makefile @@ -133,7 +133,7 @@ nullstring是一个Empty变量，其中什么也没有，而我们的space的值 dir这个变量的值是“/foo/bar”，后面还跟了4个空格，如果我们这样使用这样变量来指定别的目录——“$(dir)/file”那么就完蛋了。 -还有一个比较有用的操作符是“?=”，先看示例： +还有一个比较有用的操作符是 ``?=`` ，先看示例： .. code-block:: makefile @@ -152,7 +152,7 @@ dir这个变量的值是“/foo/bar”，后面还跟了4个空格，如果我 这里介绍两种变量的高级使用方法，第一种是变量值的替换。 -我们可以替换变量中的共有的部分，其格式是“$(var:a=b)”或是“${var:a=b}”，其意思是，把变量“var”中所有以“a”字串“结尾”的“a”替换成“b”字串。这里的“结尾”意思是“空格”或是“结束符”。 +我们可以替换变量中的共有的部分，其格式是 ``$(var:a=b)`` 或是 ``${var:a=b}`` ，其意思是，把变量“var”中所有以“a”字串“结尾”的“a”替换成“b”字串。这里的“结尾”意思是“空格”或是“结束符”。 还是看一个示例吧： @@ -161,7 +161,7 @@ dir这个变量的值是“/foo/bar”，后面还跟了4个空格，如果我 foo := a.o b.o c.o bar := $(foo:.o=.c) -这个示例中，我们先定义了一个“$(foo)”变量，而第二行的意思是把“$(foo)”中所有以“.o”字串“结尾”全部替换成“.c”，所以我们的“$(bar)”的值就是“a.c b.c c.c”。 +这个示例中，我们先定义了一个 ``$(foo)`` 变量，而第二行的意思是把 ``$(foo)`` 中所有以 ``.o`` 字串“结尾”全部替换成 ``.c`` ，所以我们的 ``$(bar)`` 的值就是“a.c b.c c.c”。 另外一种变量替换的技术是以“静态模式”（参见前面章节）定义的，如： @@ -170,7 +170,7 @@ dir这个变量的值是“/foo/bar”，后面还跟了4个空格，如果我 foo := a.o b.o c.o bar := $(foo:%.o=%.c) -这依赖于被替换字串中的有相同的模式，模式中必须包含一个“%”字符，这个例子同样让$(bar)变量的值为“a.c b.c c.c”。 +这依赖于被替换字串中的有相同的模式，模式中必须包含一个 ``%`` 字符，这个例子同样让 ``$(bar)`` 变量的值为“a.c b.c c.c”。 第二种高级用法是——“把变量的值再当成变量”。先看一个例子： @@ -191,7 +191,7 @@ dir这个变量的值是“/foo/bar”，后面还跟了4个空格，如果我 z = u a := $($($(x))) -这里的$(a)的值是“u”，相关的推导留给读者自己去做吧。 +这里的 ``$(a)`` 的值是“u”，相关的推导留给读者自己去做吧。 让我们再复杂一点，使用上“在变量定义中使用变量”的第一个方式，来看一个例子： @@ -202,7 +202,7 @@ dir这个变量的值是“/foo/bar”，后面还跟了4个空格，如果我 z = Hello a := $($(x)) -这里的$($(x))被替换成了$($(y))，因为$(y)值是“z”，所以，最终结果是：a:=$(z)，也就是“Hello”。 +这里的 ``$($(x))`` 被替换成了 ``$($(y))`` ，因为 ``$(y)`` 值是“z”，所以，最终结果是： ``a:=$(z)`` ，也就是“Hello”。 再复杂一点，我们再加上函数： @@ -214,7 +214,7 @@ dir这个变量的值是“/foo/bar”，后面还跟了4个空格，如果我 z = y a := $($($(z))) -这个例子中，“$($($(z)))”扩展为“$($(y))”，而其再次被扩展为“$($(subst 1,2,$(x)))”。$(x)的值是“variable1”，subst函数把“variable1”中的所有“1”字串替换成“2”字串，于是，“variable1”变成 “variable2”，再取其值，所以，最终，$(a)的值就是$(variable2)的值——“Hello”。（喔，好不容易） +这个例子中， ``$($($(z)))`` 扩展为 ``$($(y))`` ，而其再次被扩展为 ``$($(subst 1,2,$(x)))`` 。 ``$(x)`` 的值是“variable1”，subst函数把“variable1”中的所有“1”字串替换成“2”字串，于是，“variable1”变成 “variable2”，再取其值，所以，最终， ``$(a)`` 的值就是 ``$(variable2)`` 的值——“Hello”。（喔，好不容易） 在这种方式中，或要可以使用多个变量来组成一个变量的名字，然后再取其值： @@ -225,7 +225,7 @@ dir这个变量的值是“/foo/bar”，后面还跟了4个空格，如果我 b = second all = $($a_$b) -这里的“$a_$b”组成了“first_second”，于是，$(all)的值就是“Hello”。 +这里的 ``$a_$b`` 组成了“first_second”，于是， ``$(all)`` 的值就是“Hello”。 再来看看结合第一种技术的例子： @@ -233,10 +233,10 @@ dir这个变量的值是“/foo/bar”，后面还跟了4个空格，如果我 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”。 +这个例子中，如果 ``$(a1)`` 的值是“a”的话，那么， ``$(sources)`` 的值就是“a.c b.c c.c”；如果 ``$(a1)`` 的值是“1”，那么 ``$(sources)`` 的值是“1.c 2.c 3.c”。 再来看一个这种技术和“函数”与“条件语句”一同使用的例子： @@ -247,12 +247,12 @@ dir这个变量的值是“/foo/bar”，后面还跟了4个空格，如果我 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函数。 +这个示例中，如果定义了“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函数。 当然，“把变量的值再当成变量”这种技术，同样可以用在操作符的左边： @@ -269,25 +269,25 @@ dir这个变量的值是“/foo/bar”，后面还跟了4个空格，如果我 追加变量值 ---------- -我们可以使用“+=”操作符给变量追加值，如： +我们可以使用 ``+=`` 操作符给变量追加值，如： .. 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被追加进去了） +于是，我们的 ``$(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 @@ -301,14 +301,14 @@ dir这个变量的值是“/foo/bar”，后面还跟了4个空格，如果我 variable := value variable := $(variable) more -但如果是这种情况： +但如果是这种情况： .. code-block:: makefile variable = value variable += more -由于前次的赋值符是“=”，所以“+=”也会以“=”来做为赋值，那么岂不会发生变量的递补归定义，这是很不好的，所以make会自动为我们解决这个问题，我们不必担心这个问题。 +由于前次的赋值符是 ``=`` ，所以 ``+=`` 也会以 ``=`` 来做为赋值，那么岂不会发生变量的递补归定义，这是很不好的，所以make会自动为我们解决这个问题，我们不必担心这个问题。 override 指示符 --------------- @@ -318,7 +318,7 @@ override 指示符 .. code-block:: makefile override ; = ; - + override ; := ; 当然，你还可以追加： @@ -337,10 +337,10 @@ override 指示符 多行变量 -------- - + 还有一种设置变量值的方法是使用define关键字。使用define关键字设置变量的值可以有换行，这有利于定义一系列的命令（前面我们讲过“命令包”的技术就是利用这个关键字）。 -define指示符后面跟的是变量的名字，而重起一行定义变量的值，定义是以endef 关键字结束。其工作方式和“=”操作符一样。变量的值可以包含函数、命令、文字，或是其它变量。因为命令需要以[Tab]键开头，所以如果你用define定义的命令变量中没有以[Tab]键开头，那么make 就不会把其认为是命令。 +define指示符后面跟的是变量的名字，而重起一行定义变量的值，定义是以endef 关键字结束。其工作方式和“=”操作符一样。变量的值可以包含函数、命令、文字，或是其它变量。因为命令需要以[Tab]键开头，所以如果你用define定义的命令变量中没有以 ``Tab`` 键开头，那么make 就不会把其认为是命令。 下面的这个示例展示了define的用法： @@ -356,7 +356,7 @@ define指示符后面跟的是变量的名字，而重起一行定义变量的 make运行时的系统环境变量可以在make开始运行时被载入到Makefile文件中，但是如果Makefile中已定义了这个变量，或是这个变量由make命令行带入，那么系统的环境变量的值将被覆盖。（如果make指定了“-e”参数，那么，系统环境变量将覆盖Makefile中定义的变量） -因此，如果我们在环境变量中设置了“CFLAGS”环境变量，那么我们就可以在所有的Makefile中使用这个变量了。这对于我们使用统一的编译参数有比较大的好处。如果Makefile中定义了CFLAGS，那么则会使用Makefile中的这个变量，如果没有定义则使用系统环境变量的值，一个共性和个性的统一，很像“全局变量”和“局部变量”的特性。 +因此，如果我们在环境变量中设置了 ``CFLAGS`` 环境变量，那么我们就可以在所有的Makefile中使用这个变量了。这对于我们使用统一的编译参数有比较大的好处。如果Makefile中定义了CFLAGS，那么则会使用Makefile中的这个变量，如果没有定义则使用系统环境变量的值，一个共性和个性的统一，很像“全局变量”和“局部变量”的特性。 当make嵌套调用时（参见前面的“嵌套调用”章节），上层Makefile中定义的变量会以系统环境变量的方式传递到下层的Makefile 中。当然，默认情况下，只有通过命令行设置的变量会被传递。而定义在文件中的变量，如果要向下层Makefile传递，则需要使用exprot关键字来声明。（参见前面章节） @@ -365,7 +365,7 @@ make运行时的系统环境变量可以在make开始运行时被载入到Makefi 目标变量 -------- -前面我们所讲的在Makefile中定义的变量都是“全局变量”，在整个文件，我们都可以访问这些变量。当然，“自动化变量”除外，如“$<”等这种类量的自动化变量就属于“规则型变量”，这种变量的值依赖于规则的目标和依赖目标的定义。 +前面我们所讲的在Makefile中定义的变量都是“全局变量”，在整个文件，我们都可以访问这些变量。当然，“自动化变量”除外，如 ``$<`` 等这种类量的自动化变量就属于“规则型变量”，这种变量的值依赖于规则的目标和依赖目标的定义。 当然，我也同样可以为某个目标设置局部变量，这种变量被称为“Target-specific Variable”，它可以和“全局变量”同名，因为它的作用范围只在这条规则以及连带规则中，所以其值也只在作用范围内有效。而不会影响规则链以外的全局变量的值。 @@ -374,10 +374,10 @@ make运行时的系统环境变量可以在make开始运行时被载入到Makefi .. code-block:: makefile : ; - + : overide -;可以是前面讲过的各种赋值表达式，如“=”、“:=”、“+=”或是“？=”。第二个语法是针对于make命令行带入的变量，或是系统环境变量。 +;可以是前面讲过的各种赋值表达式，如 ``=`` 、 ``:=`` 、 ``+= ``或是 ``?=`` 。第二个语法是针对于make命令行带入的变量，或是系统环境变量。 这个特性非常的有用，当我们设置了这样一个变量，这个变量会作用到由这个目标所引发的所有的规则中去。如： @@ -386,24 +386,24 @@ make运行时的系统环境变量可以在make开始运行时被载入到Makefi 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” + +在这个示例中，不管全局的 ``$(CFLAGS)`` 的值是什么，在prog目标，以及其所引发的所有规则中（prog.o foo.o bar.o的规则）， ``$(CFLAGS)`` 的值都是 ``-g`` 模式变量 -------- 在GNU的make中，还支持模式变量（Pattern-specific Variable），通过上面的目标变量中，我们知道，变量可以定义在某个目标上。模式变量的好处就是，我们可以给定一种“模式”，可以把变量定义在符合这种模式的所有目标上。 -我们知道，make的“模式”一般是至少含有一个“%”的，所以，我们可以以如下方式给所有以[.o]结尾的目标定义目标变量： +我们知道，make的“模式”一般是至少含有一个 ``%`` 的，所以，我们可以以如下方式给所有以 ``.o`` 结尾的目标定义目标变量： .. code-block:: makefile @@ -414,8 +414,7 @@ make运行时的系统环境变量可以在make开始运行时被载入到Makefi .. code-block:: makefile ; : ; - + ; : override ; override同样是针对于系统环境传入的变量，或是make命令行指定的变量。 -