Agda User Manual v2.6.1

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

摘要

文档是Agda 2.6.1版本的用户手册，主要介绍了Agda编程语言及其相关工具的使用。手册内容包括命令行选项的详细说明，如--library、--local-interfaces等，缓存机制的开启与关闭，调试选项如显示隐式参数和不相关参数，以及实验性功能如合流检查。手册还涵盖了Agda的贡献指南，包括文档的本地渲染要求，如需要安装Python、Sphinx和LaTeX等。语言参考部分提到了抽象定义的使用，用于隐藏实现细节并加快类型检查速度。

AI总结

以下是对《Agda User Manual v2.6.1》文档内容的中文总结，语言简洁明了，重点突出核心观点和关键信息：

---

**《Agda User Manual v2.6.1》总结**

**1. 概述**
Agda是一种依赖类型的函数编程语言，支持类型检查、编译和编辑系统及相关工具和资源。本手册是Agda的官方文档，仍在完善中，欢迎通过GitHub提Pull Request或Issue进行贡献。手册的最新PDF版本可从GitHub Actions页面下载，更多资源可访问Agda Wiki网站。

对于新手，应优先参考Agda Wiki上的教程和手册中的“Getting Started”章节，而非直接阅读语言参考部分。

---

**2. 工具**
Agda的命令行选项和工具用法如下：
- **命令行选项**：
- `--include-path={DIR}`：指定导入路径。
- `--library={LIB}`：使用指定的库文件。
- `--library-file={FILE}`：替换默认库文件。
- `--local-interfaces`：新功能，接口文件存储在对应的Agda文件旁。
- `--no-default-libraries`：禁用默认库文件。
- `--no-libraries`：禁用所有库文件。

- **其他选项**：
- **缓存**：启用/禁用类型检查缓存，默认启用。
- **打印和调试**：如`--no-unicode`禁用Unicode字符，`--show-implicit`显示隐式参数，`--show-irrelevant`显示不相关参数。
- **urgent features**：如`--copatterns`启用/禁用协模式匹配，`--postfix-projections`设置后缀投影为默认。
- **实验性功能**：如`--confluence-check`启用重写规则的收敛性检查。

---

**3. 语言参考**
- **抽象定义**：
抽象定义用于隐藏实现细节或加速类型检查，类似于其他编程语言的接口或模块。具体特性：
- **非抽象块**：抽象定义不化简，行为类似postulates。
- **抽象块**：抽象定义在类型检查时化简，但类型签名检查时不化简。
- **私有类型签名**：抽象定义在私有类型签名中化简，但存在问题（参见Issue #418）。
- **范围**：`abstract`关键字的作用范围包括函数的where块和记录声明，但不包括模块。

---

**4. 贡献**
Agda及其相关库托管在GitHub，可通过fork仓库并提交Pull Request进行贡献。
- **文档**：文档使用reStructuredText格式，位于主仓库的`doc/user-manual`目录，内容自动发布到[Agda.readthedocs.io](https://agda.readthedocs.io)。
- **本地渲染文档**：需安装依赖，如Python ≥3.3、Sphinx、LaTeX等。

---

**5. 版权与许可**
Agda的开发团队和贡献者名单详见手册，主要由Ulf Norell、Andreas Abel等负责，贡献者数量众多。

---

以上为《Agda User Manual v2.6.1》文档内容的核心信息总结，重点涵盖了Agda的概述、工具用法、语言特性、贡献指南及版权信息。