Agda User Manual v2.6.1.3

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

摘要

文档是《Agda User Manual v2.6.1.3》的用户手册，涉及Agda编程语言的命令行选项、工具以及功能。Agda支持自动证明搜索（Auto）以帮助用户构建证明和程序。命令行选项包括库路径、接口文件、本地接口等。文档还介绍了如何为Agda做贡献，包括编写文档、提交代码改进和报告问题。Agda手册尚未完成，需要社区的贡献和改进。

AI总结

# Agda用户手册（版本2.6.1.3）总结

## 1. 概述
- 该手册是关于Agda编程语言及其相关工具的入门和参考指南。
- Agda是一种依赖类型的编程语言，支持交互式定理证明和编程。
- 手册目前仍在完善中，欢迎社区贡献和修正。

## 2. 工具
### 2.1 命令行选项
- **导入和库管理**：
- `--include-path={DIR}`：指定导入路径。
- `--library={DIR}`：使用指定的库。
- `--library-file={FILE}`：使用自定义的库文件。
- `--no-default-libraries`：禁用默认库。
- `--no-libraries`：完全禁用库文件。
- **缓存与调试**：
- `--caching`/`--no-caching`：启用或禁用类型检查缓存，默认启用。
- `--no-unicode`：禁用Unicode字符显示。
- `--show-implicit`：显示隐式参数。
- `--show-irrelevant`：显示不相关的参数。
- `--verbose={N}`：设置详细程度等级。
- **Copattern与投影**：
- `--copatterns`/`--no-copatterns`：启用或禁用共模式匹配，默认启用。
- `--postfix-projections`：设置后缀投影为默认。
- **实验功能**：
- `--confluence-check`：启用重写规则的收敛性检查（新功能）。

### 2.2 自动化证明搜索（Auto）
- **功能**：通过`Auto`命令实现对类型实例的自动搜索，适用于证明构造和程序片段。
- **使用方法**：在编辑时，将光标放在空白处，选择`Auto`选项或按`C-c C-a`。
- **选项**：
- `-t N`：设置超时时间（秒）。
- `-c`：允许使用情况分析。
- `-d`：尝试反驳目标。
- `-m`：使用当前模块中的定义作为提示。
- `-r`：使用范围内未限定的定义作为提示。
- `-l`：列出最多十个解决方案。
- `-s N`：提交第N个解决方案。

## 3. 贡献
- **开源社区**：Agda及其相关库托管在GitHub，社区贡献者可通过fork仓库、修改代码并发出Pull Request参与开发。
- **文档编写**：
- 使用reStructuredText格式编写文档，存放在`doc/user-manual`目录中。
- 文档支持本地渲染，需安装以下工具：
- Python ≥3.3
- Sphinx及sphinx-rtd-theme
- LaTeX
- **问题与标签**：
- 鼓励贡献者从标记为“difficulty: easy”和“help wanted”的问题开始。
- 可通过GitHub页面了解当前问题和标签。

## 4. 许可证与其他信息
- Agda拥有详细的许可证信息，可参考手册相关章节。
- 使用Agda相关内容者可参考其Wiki页面和相关教程，获取更多学习资源和使用指南。