GNU make中文手册

http://www.linuxsir.org/main/doc/gnumake/GNUmake_v3.80-zh_CN_html/index.html

GNU make中文手册

ver - 3.8

 

翻译整理：徐海兵
2004-09-11

关于本书

本文瑾献给所有热爱Linux的程序员！本中文文档版权所有。

本文比较完整的讲述GNU make工具，涵盖GNU make的用法、语法。同时重点讨论如何为一个工程编写Makefile。作为一个Linux程序员，make工具的使用以及编写Makefile是必需的。系统、详细讲述make的中文资料比较少，出于对广大中文Linuxer的支持，本人在工作之余，花了18个多月时间完成对“info make”的翻译整理，完成这个中文版手册。本书不是一个纯粹的语言翻译版本，其中对GNU make的一些语法和用法根据我个人的工作经验进行了一些详细分析和说明，也加入了一些个人的观点和实践总结。本书的所有的例子都可以在支持V3.8版本的GNU make的系统中正确执行。

由于个人水平限制，本文在一些地方存在描述不准确之处。恳请大家在阅读过程中，提出您宝贵的意见，也是对我个人的帮助。我的个人电子邮箱地址：[email protected]

。非常愿意和大家交流！共同学习。

阅读本书之前，读者应该对GNU的工具链和Linux的一些常用编程工具有一定的了解。诸如：gcc、as、ar、ld、yacc等；同时在书写Makefile时，需要能够进行一些基本的shell编程。这些工具是维护一个工程的基础。如果大家对这些工具的用法不是很熟悉，可参考项目资料。

阅读本文的几点建议：

1.        如果之前你对GNU make没有了解、当前也不想深入的学习GNU make的读者。可只阅读本文各章节前半部分的内容（作为各章节的基础知识）。

2.        如果你已经对GNU make比较熟悉，你更需要关心此版本的新增特点、功能、和之前版本不兼容之处；也可以作为开发过程过程的参考手册。

3.        之前你对GNU make没有概念、或者刚开始接触，本身又想成为一个Linux下的专业程序员，那么建议：完整学习本文的各个章节，包括了基础知识和高级用法、技巧。它会为你在Linux下的工程开发、工程管理提供非常有用的帮助。

4.        此中文文档当前版本v1.5，本文的所有勘误和最新版本可在主页 http://xhbdahai.cublog.cn 上获取！！

谢谢！

                                                       徐海兵    2005-12-31

目  录

第一章：概述

1.1   概述

1.2   准备知识

第二章：GNU make 介绍

2.1   Makefile简介

2.2   Makefile规则介绍

2.3   简单的示例

2.4   make如何工作

2.5   指定变量

2.6   自动推导规则

2.7   另类风格的makefile

2.8   清除工作目录过程文件

第三章：Makefile 总述

3.1   Makefile的内容

3.2   makefile文件的命名

3.3   包含其它makefile文件

3.4   变量 MAKEFILES

3.5   变量 MAKEFILE_LIST

3.6   其他特殊变量

3.7   makefile文件的重建

3.8   重载另外一个makefile

3.9   make如何解析makefile文件

3.9.1  变量取值

3.9.2  条件语句

3.9.3  规则的定义

3.10  总结

第四章：Makefile的规则

4.1   一个例子

4.2   规则语法

4.3   依赖的类型

4.4   文件名使用通配符

4.4.1  统配符使用举例

4.4.2  通配符存在的缺陷

4.4.3  函数wildcard

4.5   目录搜寻

4.5.1  一般搜索（变量VPATH）

4.5.2  选择性搜索（关键字vpath）

4.5.3  目录搜索的机制

4.5.4  命令行和搜索目录

4.5.5  隐含规则和搜索目录

4.5.6  库文件和搜索目录

4.6   Makefile伪目标

4.7   强制目标（没有命令或依赖的规则）

4.8   空目标文件

4.9   Makefile的特殊目标

4.10  多目标

4.11  多规则目标

4.12  静态模式

4.12.1  静态模式规则的语法

4.12.2  静态模式和隐含规则

4.13  双冒号规则

4.14  自动产生依赖

第五章：规则的命令

5.1   命令回显

5.2   命令的执行

5.3   并发执行命令

5.4   命令执行的错误

5.5   中断make的执行

5.6   make的递归执行

5.6.1  变量MAKE

5.6.2  变量和递归

5.6.3  命令行选项和递归

5.6.4  -w选项

5.7   定义命令包

5.8   空命令

第六章：Makefile中的变量

6.1   变量的引用

6.2   两种变量定义（赋值 ）

6.2.1  递归展开式变量

6.2.2  直接展开式变量

6.2.3  如何定义一个空格

6.2.4  “?=”操作符

6.3   变量的高级用法

6.3.1  变量的替换引用

6.3.2  变量的套嵌引用

6.4   变量取值

6.5   如何设置变量

6.6   追加变量值

6.7   override 指示符

6.8   多行定义

6.9   系统环境变量

6.10  目标指定变量

6.11  模式指定变量

第七章：Makefile的条件执行

7.1   一个例子

7.2   条件判断的基本语法

7.2.1  关键字“ifeq”

7.2.2  关键字“ifneq”

7.2.3  关键字“ifdef”

7.2.4  关键字“ifndef”

7.3   标记测试的条件语句

第八章：make的内嵌函数

8.1   函数的调用语法

8.2   文本处理函数

8.2.1   $(subst FROM,TO,TEXT)

8.2.2   $(patsubst PATTERN,REPLACEMENT,TEXT)

8.2.3   $(strip STRINT)

8.2.4   $(findstring FIND,IN)

8.2.5   $(filter PATTERN…,TEXT)

8.2.6   $(filter-out PATTERN...,TEXT)

8.2.7   $(sort LIST)

8.2.8   $(word N,TEXT)

8.2.9   $(wordlist S,E,TEXT)

8.2.10  $(words TEXT)

8.2.11  $(firstword NAMES…)

8.3   文件名处理函数

8.3.1   $(dir NAMES…)

8.3.2   $(notdir NAMES…)

8.3.3   $(suffix NAMES…)

8.3.4   $(basename NAMES…)

8.3.5   $(addsuffix SUFFIX,NAMES…)

8.3.6   $(addprefix PREFIX,NAMES…)

8.3.7   $(join LIST1,LIST2)

8.3.8   $(wildcard PATTERN)

8.4   foreach 函数

8.5   if 函数

8.6   call函数

8.7   value函数

8.8   eval函数

8.9   origin函数

8.10  shell函数

8.11  make的控制函数

8.11.1  $(error TEXT…)

8.11.2  $(warning TEXT…)

第九章：执行make

9.1   指定makefile文件

9.2   指定终极目标

9.3   替代命令的执行

9.4   防止特定文件重建

9.5   替换变量定义

9.6   使用make进行编译测试

9.7   make的命令行选项

第十章：make的隐含规则

10.1   隐含规则的使用

10.2   make的隐含规则一览

10.3   隐含变量

10.3.1   代表命令的变量

10.3.2   命令参数的变量

10.4   make隐含规则链

10.5   模式规则

10.5.1   模式规则介绍

10.5.2   模式规则示例

10.5.3   自动化变量

10.5.4   模式的匹配

10.5.5   万用规则

10.5.6   重建内嵌隐含规则

10.6   缺省规则

10.7   后缀规则

10.8   隐含规则搜索算法

第十一章：使用make更新静态库文件

11.1  库成员作为目标

11.2  静态库的更新

11.2.1 更新静态库的符号索引表

11.3  make静态库的注意事项

11.4  静态库的后缀规则

第十二章 ： GNU make的特点

12.1  源自System v的特点

12.2  源自其他版本的特点

12.3  GNU make自身的特点

第十三章 和其它版本的兼容

第十四章 Makefile的约定

14.1  基本的约定

14.2  规则命令行的约定

14.3  代表命令变量

14.4  安装目录变量

14.5  Makefile的标准目标名

14.6  安装命令分类

第十五章 make的常见错误信息

附录：关键字索引

1.  GNU make可识别的指示 符

2.  GNU make函数

3.  GNU make的自动化变量

4.  GNU make环境变量

后序

下一章