SCons用户手册

之前翻译到了17章，结果不小心断电丢失了。教训！ 重新来过.

=============================================================================

标题：scons用户指导 2.0.0
作者：Steven Knight

目录：
前言：
1.SCons 准则
2.本文档完整性注意事项
3.致谢
4.联系方式

第一章:创建和安装scons
1.1 安装Python
1.2 从预编译包安装SCons
1.2.1 在Red Hat(其它基于RPM)Linux系统上安装SCons
1.2.3 在Debian Linux系统上安装SCons
1.2.4 在Windows系统上安装SCons
1.3 在任意系统上构建和安装SCons
1.3.1 同时构建我安装多个版本的SCons
1.3.2 在其它系统上安装SCons
1.3.2 非管理员权限下构建和安装SCons

第二章:简单构建
2.1 C/C++程序快速构建
2.2 构建目标文件
2.3 JAVA程序快速构建
2.4 清理系统
2.5 SConstruct文件
2.5.1 SConstruct文件是Python脚本
2.5.2 SCons函数的非顺序执行

第三章:简单快速构建系统
3.1 指定目标名称
3.2 编译多个源文件
3.3 用Glob创建文件列表
3.4 指定单个文件和文件列表
3.5 使文件列表更加易懂
3.6 关键词参数
3.7 编译多个程序
3.8 在多个程序间共享源文件

 

第四章:构建和链接库文件
4.1 创建和链接库文件
4.1.1 从目标文件或源文件构建库文件
4.1.2 显式构建静态库文件:StaticLibrary构建器
4.1.3 构建动态库文件:ShareLibrary构建器
4.2 链接库文件
4.3 查找库文件:$LIBPATH变量

 

第五章：结点对象：
    5.1 返回目标结点列表的构建方法
    5.2 显式的创建文件和目录结点
    5.3 打印Node文件名
    5.4 将Node文件名作为字符串
    5.5 GetBuildPaht:从Node或字串获取路径

第六章：依赖
    6.1 Decider函数：判断输入文件何时被改变
     6.1.1 使用MD5签名判断文件是否改变
     6.1.2 使用时间戳判断文件是否改变
     6.1.3 使用MD5签名和时间戳来判断文件是否改变
     6.1.4 自定义Decider函数
     6.1.5 混合多种方法来决断文件是否改变
    6.2 过时的函数决断文件是否改变
     6.2.1 SourceSignatures函数
     6.2.2 TargetSignatures函数
    6.3 隐式依赖：$CPPPATH结构变量
    6.4 缓存隐式依赖关系：
     6.4.1 --implicit-deps-changd选项
     6.4.2 --implicit-deps-unchanged选项
    6.5 显式依赖：Depens函数
    6.6 从外部文件获取依赖：ParseDepends函数
    6.7 忽略依赖：Ignore函数
    6.8 顺序依赖：Requires函数
    6.9 AlwaysBuild函数

第七章:环境变量
    7.1 使用外部环境变量
    7.2 创建环境变量
     7.2.1 创建结构变量：Environment函数
     7.2.1 从Construction Environment获取环境变量
     7.2.3 从Construction Environment扩展环境变量:Subst方法
     7.2.4 处理值扩展问题
     7.2.5 控制默认Construction Environment:DefualtEnvironment函数
     7.2.6 多个Construction Environment
     7.2.7 拷贝Construction Environment:Clone方法
     7.2.8 替换值：Replace方法
     7.2.9 设置默认值：SetDfault方法
     7.2.10 追加环境变量:Appen方法
     7.2.11 追加唯一环境变量：AppendUnique方法
     7.2.12 追加至环境变量的起始位置：Prepend方法
     7.2.13 追加唯一环境变量至起始位置：PrependUnique方法
    7.3 控制Issued Commands的执行环境
     7.3.1 从外部环境继承PATH
     7.3.2 在执行环境中添加PATH

第八章：自动添加命令行选项到结构变量
    8.1 合并选项到环境变量：MergeFlags函数
    8.2 抽取编译参数到环境变量：ParseFlags函数
    8.3 查找安装库信息：ParseConfig函数

第九章:控制编译输出
    9.1 提供编译帮助：Help函数
    9.2 控制SCons打印编译命令：￥*COMSTAR
    9.3 提供编译过程的输出：Progress函数
    9.4 打印编译的详细状态：GetBuildFailures函数

第十章：从命令行控制编译
    10.1 命令行选项
     10.1.1 无需每次都指定命令行选项：SCONSFLAGS环境变量
     10.1.2 获取命令行设定的值：GetOpton函数
     10.1.3 设定命令行选项：SetOption函数
     10.1.4 获取或设定命令行选项字串
     10.1.5 添加自定义命令行选项：AddOption函数
    10.2 命令行变量variable=value编译变量
     10.2.1 控制命令行编译的变量
     10.2.2 提供命令行帮助的编译变量
     10.2.3 从文件中读取编译变量
     10.2.4 预定义编译变量函数
     10.2.5 一次添加多个命令行编译变量
     10.2.6 处理未知命令行编译变量:UnknownVariables函数
    10.3 命令行目标
     10.3.1 获取命令行目标:COMMAND)LINE_TARGETS变量
     10.3.2 控制默认目标:Default函数
     10.3.3 获取编译目标列表,无论原始目标是什么:BUILD_TARGETS

第十一章：从其它目录安装文件：Install构建器
    11.1 在一个目录中安装多个文件
    11.2 用不同的文件名安装一个文件
    11.3 用不同的文件名安装多个文件

第十二章：平台不相关文件系统操作
    12.1 拷贝文件或目录：Copy代理
    12.2 删除文件或目录：Delete
    12.3 移动或重命名文件或目录：Move
    12.4 更新文件修改时间：Touch
    12.5 创建目录：Mkdir
    12.6 改变文件或目录权限：Chmod
    12.7 立即执行命令：Execute

第十三章：移除目标
    13.1 阻止目标在编译过程中被移除:
    13.2 阻止目标在清理过程中被移除:NoClean函数
    13.3 清理系统中移除附加性文件:Clean函数