redo 项目技术文档

1. 安装指南

安装依赖

在安装 redo 之前，请确保您的系统中已经安装了以下依赖：

• GCC 或 Clang 编译器
• make 工具

源码安装

从 GitHub 下载最新的 redo 源码，然后执行以下命令进行编译和安装：

git clone https://github.com/apenwarr/redo.git
cd redo
./do -j10 test
sudo DESTDIR= PREFIX=/usr/local ./do -j10 install

这里，-j10 参数表示并行编译，使用 10 个进程。您可以根据您的 CPU 核心数调整该参数。

2. 项目使用说明

redo 是一个递归构建系统，比 make 更小、更简单、更强大、更可靠。以下是一些基本的使用方法：

基本用法

创建一个名为 do 的文件，其中包含构建规则。例如：

# do 文件内容
redo-ifchange output.txt

echo "Building output.txt"
echo "Some data" > output.txt

上面的例子中，redo-ifchange 命令检查 output.txt 是否依赖于其他文件。如果依赖文件发生变化，则重新执行后续命令。

并行构建

redo 支持并行构建。在执行 redo 命令时，可以使用 -j 参数指定并行进程数：

redo -j10

日志和调试

redo 提供了详细的日志和调试功能。您可以通过以下命令查看构建日志：

redo -v

3. 项目API使用文档

redo 的 API 相对简单，主要包括以下几个命令：

• redo: 开始一个新的构建过程。
• redo-ifchange: 如果依赖文件发生变化，则重新构建。
• redo-always: 无论依赖文件是否变化，都重新构建。
• redo-stamp: 为构建生成时间戳。

更多命令和用法请参考官方文档。

4. 项目安装方式

如前所述，您可以通过以下命令安装 redo：

sudo DESTDIR= PREFIX=/usr/local ./do -j10 install

这将 redo 安装到 /usr/local 目录下。您可以通过修改 PREFIX 环境变量来改变安装路径。