Agda User Manual v2.6.4.1

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

摘要

文档详细介绍了Agda 2.6.4.1版本的用户手册，包括各项命令行选项、版本更新信息、用户贡献指南以及配置选项。这些选项涵盖了功能启用、性能优化、编译设置等方面，旨在帮助开发人员和高级用户更好地使用和定制Agda。

AI总结

《Agda User Manual v2.6.4.1》主要介绍了Agda编程语言的命令行选项、性能优化、开发者指南以及文档贡献指南。以下是核心内容的总结：

### 1. **命令行选项**
- **语言功能选项**：
- `--cubical`：启用立方体类型理论功能。
- `--erased-cubical`：启用立方体Agda的变体。
- `--experimental-irrelevance`：启用不重要性功能（如无关级别、无关数据匹配）。
- `--guarded`：启用保护递归锁和刻度。
- `--injective-type-constructors`：启用注入式类型构造函数（可能导致系统不一致）。
- `--irrelevant-projections`：启用（或禁用）无关记录字段的投影。
- `--lossy-unification`：启用类似于一阶统一的约束求解启发法。
- `--prop`：启用或禁用定义上无关的命题声明。
- **模式匹配与等式**：
- `--exact-split`：要求（或不要求）定义中的所有子句作为定义等式。
- `--hidden-argument-puns`：启用（或禁用）隐藏参数惯例。
- `--no-eta-equality`：默认禁用记录的 eta 等式。
- `--cohesion`：启用凝聚力模式（如 `@♭`）。
- `--flat-split`：启用 `@♭` 参数的模式匹配。
- `--no-pattern-matching`：完全禁用模式匹配。
- **编译选项**：
- `--compile-dir`：设置编译输出目录。
- `--no-main`：不将当前模块视为程序的主模块。
- `--with-compiler`：设置编译器路径（默认为 `ghc`）。
- **警告与版本信息**：
- `--warning`：设置警告组或标志。
- `--version`：显示版本号。
- `--numeric-version`：仅显示版本号。
- `--print-agda-dir`：输出Agda数据文件根目录。

### 2. **性能优化选项**
- `--auto-inline`：启用自动内联。
- `--caching`：启用（或禁用）类型检查缓存，默认启用。
- `--call-by-name`：禁用调用名 평가，启用调用需要 평가。
- `--fast-reduce`：启用快速还原。
- `--no-forcing`：禁用强制优化。
- `--no-projection-like`：关闭投影样类分析。

### 3. **开发者指南**
- Agda及其相关库托管在GitHub，用户可以通过分支、提交更改并创建Pull Request参与贡献。
- 问题解决：标签 `difficulty: easy` 和 `help wanted` 适合初学者。
- 文档贡献：文档采用reStructuredText格式，位于 `doc/user-manual` 目录，可本地渲染。

### 4. **文档本地渲染**
- 依赖：Python ≥3.3、Sphinx、ImageMagick、LaTeX、PyDvi。
- 使用 `make html` Builds HTML文档，`make help` 查看可用目标。

### 5. **总结**
- 本手册详细介绍了Agda的命令行选项、性能优化、开发者指南和文档贡献指南，适合开发者和新手参考。
- Agda的手册仍在完善中，欢迎社区贡献内容以改进文档。

通过以上总结，用户可以快速了解Agda的核心功能和使用指南。