Harlan 编译器项目教程

1. 项目目录结构及介绍

Harlan 是一个针对 GPU 计算的领域特定语言（DSL），项目的目录结构如下：

• AUTHORS.txt: 作者列表文件。
• external: 存放外部依赖的 git 子模块，如 Nanopass Framework 和 Elegant Weapons。
• harlan: Harlan 编译器的源代码。
• lib: Harlan 的标准库。
• rt: Harlan 的运行时库。
• test: Harlan 的测试用例和基准测试。
• test.bin: 测试运行器 run-tests.scm 存储编译后的二进制文件和程序输出。
• travis: 运行 Harlan 测试套件的支持文件，用于 Travis CI。
• util: 杂项 Scheme 文件，包括不同 Scheme 实现的兼容性填充。
• Makefile: 编译和构建项目的配置文件。
• README.md: 项目说明文件。
• LICENSE: 项目许可证文件。

2. 项目的启动文件介绍

Harlan 编译器的启动文件是 harlanc，它是编译器的主要入口点。当你运行 ./harlanc hello.kfc 时，它会编译名为 hello.kfc 的 Harlan 源文件。编译器支持 -v 选项，用于在编译过程中输出详细的中间结果，便于调试。

./harlanc -v hello.kfc

编译成功后，会生成一个与源文件同名的可执行文件，例如 hello，这个文件可以直接运行。

3. 项目的配置文件介绍

项目的配置文件主要是 Makefile，它用于指导 make 工具如何编译和构建项目。在 Makefile 中，你可以定义编译器选项、依赖关系以及构建流程。

此外，项目还包含 .travis.yml 文件，它是用于配置在 Travis CI 持续集成服务上运行测试的配置文件。该文件定义了构建环境、运行步骤以及通知设置等。

在 test 目录下，run-tests.scm 是一个 Scheme 脚本，用于运行测试用例。它负责编译测试文件、执行它们，并验证输出是否符合预期。

通过这些配置文件，你可以方便地构建和测试 Harlan 编译器，确保其功能的正确性和稳定性。