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

fix warnings

Browse Source
This commit is contained in:
Dongdong Tian 2017-06-17 15:14:54 +08:00
parent 63f5a8ddbe
commit 572ca99ce2
2 changed files with 22 additions and 22 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

42
source/functions.rst
View File

@ -70,10 +70,10 @@ patsubst
- 名称：模式字符串替换函数。 - 名称：模式字符串替换函数。
- 功能：查找 ``<text>`` 中的单词（单词以“空格”、“Tab”或“回车”“换行”分隔）是否符合模式 - 功能：查找 ``<text>`` 中的单词（单词以“空格”、“Tab”或“回车”“换行”分隔）是否符合模式
``<pattern>`` ，如果匹配的话，则以 ``<replacement>`` 替换。这里， ``<pattern>`` 可以 ``<pattern>`` ，如果匹配的话，则以 ``<replacement>`` 替换。这里， ``<pattern>`` 可以
包括通配符 ``%`` ，表示任意长度的字串。如果 ``<replacement>`` 中也包含 ``%`` ，那么， 包括通配符 ``%`` ，表示任意长度的字串。如果 ``<replacement>`` 中也包含 ``%`` ，那么，
``<replacement>`` 中的这个 ``%`` 将是 ``<pattern>`` 中的那个 ``%`` 所代表的字串。 ``<replacement>`` 中的这个 ``%`` 将是 ``<pattern>`` 中的那个 ``%`` 所代表的字串。
（可以用 ``\`` 来转义，以 ``\%`` 来表示真实含义的 ``%`` 字符） （可以用 ``\`` 来转义，以 ``\%`` 来表示真实含义的 ``%`` 字符）
- 返回：函数返回被替换过后的字符串。 - 返回：函数返回被替换过后的字符串。
- 示例： - 示例：
@ -85,10 +85,10 @@ patsubst
``x.c.o bar.o`` ``x.c.o bar.o``
- 备注：这和我们前面“变量章节”说过的相关知识有点相似。如 - 备注：这和我们前面“变量章节”说过的相关知识有点相似。如
``$(var:<pattern>=<replacement>;)`` 相当于 ``$(var:<pattern>=<replacement>;)`` 相当于
``$(patsubst <pattern>,<replacement>,$(var))`` ，而 ``$(patsubst <pattern>,<replacement>,$(var))`` ，而
``$(var: <suffix>=<replacement>)`` 则相当于 ``$(var: <suffix>=<replacement>)`` 则相当于
``$(patsubst %<suffix>,%<replacement>,$(var))`` 。 ``$(patsubst %<suffix>,%<replacement>,$(var))`` 。
例如有:: 例如有::
@ -142,7 +142,7 @@ filter
- 名称：过滤函数 - 名称：过滤函数
- 功能：以 ``<pattern>`` 模式过滤 ``<text>`` 字符串中的单词，保留符合模式 - 功能：以 ``<pattern>`` 模式过滤 ``<text>`` 字符串中的单词，保留符合模式
``<pattern>`` 的单词。可以有多个模式。 ``<pattern>`` 的单词。可以有多个模式。
- 返回：返回符合模式 ``<pattern>`` 的字串。 - 返回：返回符合模式 ``<pattern>`` 的字串。
- 示例： - 示例：
@ -163,7 +163,7 @@ filter-out
- 名称：反过滤函数 - 名称：反过滤函数
- 功能：以 ``<pattern>`` 模式过滤 ``<text>`` 字符串中的单词，去除符合模式 - 功能：以 ``<pattern>`` 模式过滤 ``<text>`` 字符串中的单词，去除符合模式
``<pattern>`` 的单词。可以有多个模式。 ``<pattern>`` 的单词。可以有多个模式。
- 返回：返回不符合模式 ``<pattern>`` 的字串。 - 返回：返回不符合模式 ``<pattern>`` 的字串。
- 示例： - 示例：
@ -197,7 +197,7 @@ word
- 名称：取单词函数 - 名称：取单词函数
- 功能：取字符串 ``<text>`` 中第 ``<n>`` 个单词。（从一开始） - 功能：取字符串 ``<text>`` 中第 ``<n>`` 个单词。（从一开始）
- 返回：返回字符串 ``<text>`` 中第 ``<n>`` 个单词。如果 ``<n>`` 比 ``<text>`` 中的 - 返回：返回字符串 ``<text>`` 中第 ``<n>`` 个单词。如果 ``<n>`` 比 ``<text>`` 中的
单词数要大，那么返回空字符串。 单词数要大，那么返回空字符串。
- 示例： ``$(word 2, foo bar baz)`` 返回值是 ``bar`` 。 - 示例： ``$(word 2, foo bar baz)`` 返回值是 ``bar`` 。
wordlist wordlist
@ -209,10 +209,10 @@ wordlist
- 名称：取单词串函数 - 名称：取单词串函数
- 功能：从字符串 ``<text>`` 中取从 ``<ss>`` 开始到 ``<e>`` 的单词串。 ``<ss>`` - 功能：从字符串 ``<text>`` 中取从 ``<ss>`` 开始到 ``<e>`` 的单词串。 ``<ss>``
和 ``<e>`` 是一个数字。 和 ``<e>`` 是一个数字。
- 返回：返回字符串 ``<text>`` 中从 ``<ss>`` 到 ``<e>`` 的单词字串。如果 ``<ss>`` - 返回：返回字符串 ``<text>`` 中从 ``<ss>`` 到 ``<e>`` 的单词字串。如果 ``<ss>``
比 ``<text>`` 中的单词数要大，那么返回空字符串。如果 ``<e>`` 大于 ``<text>`` 的单词数， 比 ``<text>`` 中的单词数要大，那么返回空字符串。如果 ``<e>`` 大于 ``<text>`` 的单词数，
那么返回从 ``<ss>`` 开始，到 ``<text>`` 结束的单词串。 那么返回从 ``<ss>`` 开始，到 ``<text>`` 结束的单词串。
- 示例： ``$(wordlist 2, 3, foo bar baz)`` 返回值是 ``bar baz`` 。 - 示例： ``$(wordlist 2, 3, foo bar baz)`` 返回值是 ``bar baz`` 。
words words
@ -227,7 +227,7 @@ words
- 返回：返回 ``<text>`` 中的单词数。 - 返回：返回 ``<text>`` 中的单词数。
- 示例： ``$(words, foo bar baz)`` 返回值是 ``3`` 。 - 示例： ``$(words, foo bar baz)`` 返回值是 ``3`` 。
- 备注：如果我们要取 ``<text>`` 中最后的一个单词，我们可以这样： - 备注：如果我们要取 ``<text>`` 中最后的一个单词，我们可以这样：
``$(word $(words <text>),<text>)`` 。 ``$(word $(words <text>),<text>)`` 。
firstword firstword
~~~~~~~~~ ~~~~~~~~~
@ -269,7 +269,7 @@ dir
- 名称：取目录函数——dir。 - 名称：取目录函数——dir。
- 功能：从文件名序列 ``<names>`` 中取出目录部分。目录部分是指最后一个反斜杠（ ``/`` ）之前 - 功能：从文件名序列 ``<names>`` 中取出目录部分。目录部分是指最后一个反斜杠（ ``/`` ）之前
的部分。如果没有反斜杠，那么返回 ``./`` 。 的部分。如果没有反斜杠，那么返回 ``./`` 。
- 返回：返回文件名序列 ``<names>`` 的目录部分。 - 返回：返回文件名序列 ``<names>`` 的目录部分。
- 示例： ``$(dir src/foo.c hacks)`` 返回值是 ``src/ ./`` 。 - 示例： ``$(dir src/foo.c hacks)`` 返回值是 ``src/ ./`` 。
@ -282,7 +282,7 @@ notdir
- 名称：取文件函数——notdir。 - 名称：取文件函数——notdir。
- 功能：从文件名序列 ``<names>`` 中取出非目录部分。非目录部分是指最後一个反斜杠（ ``/`` ） - 功能：从文件名序列 ``<names>`` 中取出非目录部分。非目录部分是指最後一个反斜杠（ ``/`` ）
之后的部分。 之后的部分。
- 返回：返回文件名序列 ``<names>`` 的非目录部分。 - 返回：返回文件名序列 ``<names>`` 的非目录部分。
- 示例: ``$(notdir src/foo.c hacks)`` 返回值是 ``foo.c hacks`` 。 - 示例: ``$(notdir src/foo.c hacks)`` 返回值是 ``foo.c hacks`` 。
@ -309,7 +309,7 @@ basename
- 功能：从文件名序列 ``<names>`` 中取出各个文件名的前缀部分。 - 功能：从文件名序列 ``<names>`` 中取出各个文件名的前缀部分。
- 返回：返回文件名序列 ``<names>`` 的前缀序列，如果文件没有前缀，则返回空字串。 - 返回：返回文件名序列 ``<names>`` 的前缀序列，如果文件没有前缀，则返回空字串。
- 示例： ``$(basename src/foo.c src-1.0/bar.c hacks)`` 返回值是 - 示例： ``$(basename src/foo.c src-1.0/bar.c hacks)`` 返回值是
``src/foo src-1.0/bar hacks`` 。 ``src/foo src-1.0/bar hacks`` 。
addsuffix addsuffix
~~~~~~~~~ ~~~~~~~~~
@ -344,9 +344,9 @@ join
- 名称：连接函数——join。 - 名称：连接函数——join。
- 功能：把 ``<list2>`` 中的单词对应地加到 ``<list1>`` 的单词后面。如果 ``<list1>`` 的 - 功能：把 ``<list2>`` 中的单词对应地加到 ``<list1>`` 的单词后面。如果 ``<list1>`` 的
单词个数要比 ``<list2>`` 的多，那么， ``<list1>`` 中的多出来的单词将保持原样。如果 单词个数要比 ``<list2>`` 的多，那么， ``<list1>`` 中的多出来的单词将保持原样。如果
``<list2>`` 的单词个数要比 ``<list1>`` 多，那么， ``<list2>`` 多出来的单词将被复制到 ``<list2>`` 的单词个数要比 ``<list1>`` 多，那么， ``<list2>`` 多出来的单词将被复制到
``<list1>`` 中。 ``<list1>`` 中。
- 返回：返回连接过后的字符串。 - 返回：返回连接过后的字符串。
- 示例： ``$(join aaa bbb , 111 222 333)`` 返回值是 ``aaa111 bbb222 333`` 。 - 示例： ``$(join aaa bbb , 111 222 333)`` 返回值是 ``aaa111 bbb222 333`` 。

2
source/implicit_rules.rst
View File

@ -327,7 +327,7 @@ make就会规则下的命令，所以，在模式规则中，目标可能会是
目标中模式定义的集合。 目标中模式定义的集合。
- ``$%`` : 仅当目标是函数库文件中，表示规则中的目标成员名。例如，如果一个目标是 ``foo.a(bar.o)`` ， - ``$%`` : 仅当目标是函数库文件中，表示规则中的目标成员名。例如，如果一个目标是 ``foo.a(bar.o)`` ，
那么， ``$%`` 就是 ``bar.o`` ， ``$@`` 就是 ``foo.a`` 。如果目标不是函数库文件 那么， ``$%`` 就是 ``bar.o`` ， ``$@`` 就是 ``foo.a`` 。如果目标不是函数库文件
（Unix下是 ``.a`` ，Windows下是 ``.lib`` ），那么，其值为空。 （Unix下是 ``.a`` ，Windows下是 ``.lib`` ），那么，其值为空。
- ``$<`` : 依赖目标中的第一个目标名字。如果依赖目标是以模式（即 ``%`` ）定义的，那么 ``$<`` - ``$<`` : 依赖目标中的第一个目标名字。如果依赖目标是以模式（即 ``%`` ）定义的，那么 ``$<``
将是符合模式的一系列的文件集。注意，其是一个一个取出来的。 将是符合模式的一系列的文件集。注意，其是一个一个取出来的。
- ``$?`` : 所有比目标新的依赖目标的集合。以空格分隔。 - ``$?`` : 所有比目标新的依赖目标的集合。以空格分隔。