Agda User Manual v2.5.4.1

以下是对《Agda User Manual v2.5.4.1》文档内容的总结，语言简洁明了，突出核心观点和关键信息： --- ### 《Agda User Manual v2.5.4.1》总结 #### **1. 安装** - **安装方式**： - 通过Hackage安装：`cabal update` 和 `cabal install Agda agda-mode setup`。 - 系统特定包： - Arch Linux：预建包 `Agda` 和 `agda-stdlib`。 - Debian/Ubuntu：使用 `apt-get` 安装 `agda-mode`、`agda` 和 `agda-stdlib`。 - Fedora：通过 `yum` 安装 `Agda`，自动包含 `emacs-agda-mode` 和 `ghc-Agda-devel`。 - FreeBSD：从 FreshPorts 安装 Agda 和标准库。 - NixOS：通过 `nix-env` 安装 `haskellPackages.Agda`。 - OS X：使用 Homebrew 安装 `agda`，包含 standard library。 - **注意事项**：安装完成后需手动配置 `~/.agda/libraries` 和 `~/.agda/defaults` 文件。 #### **2. 工具** - **Agda 模式**：Emacs 中使用 `M-x agda2-mode` 切换模式。 - **批量命令**：命令行工具 `agda` 搭配 `--help` 查看更多选项。 #### **3. 编译器** - **后端**： - **GHC 后端**：将 Agda 程序翻译为 Haskell，使用 `--compile` 标志。 - **JavaScript 后端**：将 Agda 代码翻译为 JavaScript。 - **优化**： - 内置自然数 (`builtin natural numbers`) 和可擦除类型 (`erasable types`)。 - **示例**：通过 Foreign Function Interfaceivial 示例实现 "Hello, World!"。 #### **4. 库管理** - **库文件**：包含 `name` 和 `dependencies`。 - **使用标准库**： - 创建 `~/.agda/libraries` 文件，内容为标准库路径。 - 创建 `~/.agda/defaults` 文件，内容为 `standard-library`。 #### **5. 文档** - **编写文档**：使用 reStructuredText（.rst）格式，代码示例需通过 Agda 类型检查。 - **本地构建文档**： - 依赖项：Python 3.3、Sphinx、LaTeX、dvipng。 - 执行 `make html` 生成 HTML 文档。 - **代码示例语法**： - **可见且类型正确的代码**：使用 `::` 序列。 - **代码块**：支持独立代码或位于段落末尾。 #### **6. 贡献** - 文档托管在 `doc/user-manual` 目录，发布到 [agda.readthedocs.io](https://agda.readthedocs.io)。 - 贡献方式：通过 GitHub 提交 pull request 或 issue。 --- 以上是文档的核心内容和关键信息的总结，涵盖了安装、工具、编译器、库管理、文档编写和贡献等主要部分，语言简洁明了，逻辑清晰。