From c744424ac28aad252dad16f4b459dde6a9ab9cdd Mon Sep 17 00:00:00 2001 From: Liwen Jiang Date: Wed, 3 Apr 2019 14:58:28 -0500 Subject: [PATCH] Submit Translatted Passage for Review Submit Translatted Passage for Review --- ...iscovering make- the power behind rules.md | 101 ------------------ ...iscovering make- the power behind rules.md | 101 ++++++++++++++++++ 2 files changed, 101 insertions(+), 101 deletions(-) delete mode 100644 sources/tech/20180118 Rediscovering make- the power behind rules.md create mode 100644 translated/tech/20180118 Rediscovering make- the power behind rules.md diff --git a/sources/tech/20180118 Rediscovering make- the power behind rules.md b/sources/tech/20180118 Rediscovering make- the power behind rules.md deleted file mode 100644 index 143b852da0..0000000000 --- a/sources/tech/20180118 Rediscovering make- the power behind rules.md +++ /dev/null @@ -1,101 +0,0 @@ -tomjlw is translating -Rediscovering make: the power behind rules -====== - -![](https://user-images.githubusercontent.com/4419992/35015638-0529f1c0-faf4-11e7-9801-4995fc4b54f0.jpg) - -I used to think makefiles were just a convenient way to list groups of shell commands; over time I've learned how powerful, flexible, and full-featured they are. This post brings to light over some of those features related to rules. - -### Rules - -Rules are instructions that indicate `make` how and when a file called the target should be built. The target can depend on other files called prerequisites. - -You instruct `make` how to build the target in the recipe, which is no more than a set of shell commands to be executed, one at a time, in the order they appear. The syntax looks like this: -``` -target_name : prerequisites - recipe -``` - -Once you have defined a rule, you can build the target from the command line by executing: -``` -$ make target_name -``` - -Once the target is built, `make` is smart enough to not run the recipe ever again unless at least one of the prerequisites has changed. - -### More on prerequisites - -Prerequisites indicate two things: - - * When the target should be built: if a prerequisite is newer than the target, `make` assumes that the target should be built. - * An order of execution: since prerequisites can, in turn, be built by another rule on the makefile, they also implicitly set an order on which rules are executed. - - - -If you want to define an order, but you don't want to rebuild the target if the prerequisite changes, you can use a special kind of prerequisite called order only, which can be placed after the normal prerequisites, separated by a pipe (`|`) - -### Patterns - -For convenience, `make` accepts patterns for targets and prerequisites. A pattern is defined by including the `%` character, a wildcard that matches any number of literal characters or an empty string. Here are some examples: - - * `%`: match any file - * `%.md`: match all files with the `.md` extension - * `prefix%.go`: match all files that start with `prefix` that have the `.go` extension - - - -### Special targets - -There's a set of target names that have special meaning for `make` called special targets. - -You can find the full list of special targets in the [documentation][1]. As a rule of thumb, special targets start with a dot followed by uppercase letters. - -Here are a few useful ones: - -**.PHONY** : Indicates `make` that the prerequisites of this target are considered to be phony targets, which means that `make` will always run it's recipe regardless of whether a file with that name exists or what its last-modification time is. - -**.DEFAULT** : Used for any target for which no rules are found. - -**.IGNORE** : If you specify prerequisites for `.IGNORE`, `make` will ignore errors in execution of their recipes. - -### Substitutions - -Substitutions are useful when you need to modify the value of a variable with alterations that you specify. - -A substitution has the form `$(var:a=b)` and its meaning is to take the value of the variable `var`, replace every `a` at the end of a word with `b` in that value, and substitute the resulting string. For example: -``` -foo := a.o -bar : = $(foo:.o=.c) # sets bar to a.c -``` - -note: special thanks to [Luis Lavena][2] for letting me know about the existence of substitutions. - -### Archive Files - -Archive files are used to collect multiple data files together into a single file (same concept as a zip file), they are built with the `ar` Unix utility. `ar` can be used to create archives for any purpose, but has been largely replaced by `tar` for any other purposes than [static libraries][3]. - -In `make`, you can use an individual member of an archive file as a target or prerequisite as follows: -``` -archive(member) : prerequisite - recipe -``` - -### Final Thoughts - -There's a lot more to discover about make, but at least this counts as a start, I strongly encourage you to check the [documentation][4], create a dumb makefile, and just play with it. - --------------------------------------------------------------------------------- - -via: https://monades.roperzh.com/rediscovering-make-power-behind-rules/ - -作者：[Roberto Dip][a] -译者：[tomjlw](https://github.com/tomjlw) -校对：[校对者ID](https://github.com/校对者ID) - -本文由 [LCTT](https://github.com/LCTT/TranslateProject) 原创编译，[Linux中国](https://linux.cn/) 荣誉推出 - -[a]:https://monades.roperzh.com -[1]:https://www.gnu.org/software/make/manual/make.html#Special-Targets -[2]:https://twitter.com/luislavena/ -[3]:http://tldp.org/HOWTO/Program-Library-HOWTO/static-libraries.html -[4]:https://www.gnu.org/software/make/manual/make.html diff --git a/translated/tech/20180118 Rediscovering make- the power behind rules.md b/translated/tech/20180118 Rediscovering make- the power behind rules.md new file mode 100644 index 0000000000..263e6bd0cd --- /dev/null +++ b/translated/tech/20180118 Rediscovering make- the power behind rules.md @@ -0,0 +1,101 @@ +重新发现 make： 规则背后的力量 +====== + +![](https://user-images.githubusercontent.com/4419992/35015638-0529f1c0-faf4-11e7-9801-4995fc4b54f0.jpg) + +我过去认为 makefiles 只是一种将一组组的 shell 命令列出来的简便方法；过了一段时间我了解到它们是有多么的强大、灵活以及功能齐全。这篇文章带你领略其中一些有关规则的特性。 + +### 规则 + +规则是表明 `make` 如何并且何时搭建一个被称作为目标（target）的文件的指令。目标文件可以依赖于其它被称作为前提（prerequisite）的文件。 + +你指明 `make` 如何在配方（recipe）中搭建目标，这个过程不过是一套按照出现顺序一次执行一个的 shell 命令。像这样的句法： +``` +target_name : prerequisites + recipe +``` + +一但你定义好了规则，你就可以通过从命令行执行以下命令搭建目标： +``` +$ make target_name +``` + +目标一经搭建，除非前提改变，否则 `make` 会足够聪明地不再去运行配方。 + +### 关于前提的更多信息 + +前提表明了两件事情： + +* 当目标应当被搭建时：如果其中一个前提比目标更新，`make` 假定目的应当被搭建。 +* 执行的顺序：鉴于前提可以反过来在 makefile 中被另一套规则所搭建，它们同样暗中定下了一个执行规则的顺序。 + + + +如果你想要定义一个顺序但是你不想在前提改变的时候重新搭建目标，你可以使用一种特别的叫做“唯顺序”的前提。这种前提可以被放在普通的前提之后，用管道符（`|`）进行分隔。 + +### 样式 + +为了便利，`make` 接受目标和前提的样式。通过包含 `%` 符号可以定义一种式样。这个符号是一个可以匹配任何长度的文字符号或者空隔的通配符。以下有一些示例： + +* `%`：匹配任何文件 +* `%.md`：匹配所有 `.md` 结尾的文件 +* `prefix%.go`：匹配所有以 `prefix` 开头以 `go` 结尾的文件 + + + +### 特殊目标 + +有一系列目标名字，它们对于 `make` 来说有特殊的意义，被称作特殊目标。 + +你可以在这个[文档][1]发现全套特殊目标。作为一种经验法则，特殊目标以点开始后面跟着大写字母。 + +以下是几个有用的特殊目标： + +**.PHONY**：向 `make` 表明此目标的前提被当成伪目标。这意味着 `make` 将总是运行无论有那个名字的文件是否存在或者上次被修改的时间是什么。 + +**.DEFAULT**：被用于任何没有规则的目标。 + +**.IGNORE**：如果你指定 **.IGNORE** 为前提，`make` 将忽略执行配方过程中的错误。 + +### 替代（substitution） + +当你需要以你指定的改动方式改变一个变量的值，替代就十分有用了。 + +一个替代有着 `$(var:a=b)` 的形式，它的意思是获取变量 `var` 的值，用值里面的 `b` 替代词末尾的每个 `a` 以代替最终的字符串。例如： +``` +foo := a.o +bar : = $(foo:.o=.c) # sets bar to a.c +``` + + +注意：特别感谢 [Luis Lavena][2] 让我们知道替代的存在。 + +### 档案文件 + +档案文件是用来一起将多个数据文档（和压缩文件同样的概念）收集成一个文件。它们由 `ar` Unix 设施搭建。`ar` 可以被用来为任何目的创建档案，但除了在[静态库][3]方面已经被 `tar` 大量替代。 + +在 `make` 中，你可以使用一个档案文件中的单独一个成员作为目标或者前提，就像这样： +``` +archive(member) : prerequisite + recipe +``` + +### 最后的想法 + +关于 make 还有更多可探索的，但是至少这是一个起点，我强烈鼓励你去查看[文档][4]，创建一个笨拙的 makefile 然后就可以探索它了。 + +-------------------------------------------------------------------------------- + +via: https://monades.roperzh.com/rediscovering-make-power-behind-rules/ + +作者：[Roberto Dip][a] +译者：[tomjlw](https://github.com/tomjlw) +校对：[校对者ID](https://github.com/校对者ID) + +本文由 [LCTT](https://github.com/LCTT/TranslateProject) 原创编译，[Linux中国](https://linux.cn/) 荣誉推出 + +[a]:https://monades.roperzh.com +[1]:https://www.gnu.org/software/make/manual/make.html#Special-Targets +[2]:https://twitter.com/luislavena/ +[3]:http://tldp.org/HOWTO/Program-Library-HOWTO/static-libraries.html +[4]:https://www.gnu.org/software/make/manual/make.html