Agda User Manual v2.5.4.1

• 语言: 英语
• 格式: .pdf
• 来源: agda.readthedocs.io

摘要

Agda User Manual Release 2.5.4.1 The Agda Team Jul 19, 2018 Contents 1 Overview 1 2 Getting Started 3 2.1 Prerequisites . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 2.2 Installation . . . . . . .

AI总结

以下是对《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。

---

以上是文档的核心内容和关键信息的总结，涵盖了安装、工具、编译器、库管理、文档编写和贡献等主要部分，语言简洁明了，逻辑清晰。