Debian 新维护者手册

• 语言: 中文（简体）
• 格式: .pdf
• 来源: www.debian.org

摘要

《Debian 新维护者手册》详细介绍了 Debian 软件包的维护和打包过程，包括开发工具的使用、构建命令的层级结构以及相关文档的重要性。文档强调了遵循 Debian Policy Manual 和 Developer's Reference 的必要性，并提供了关于初始化外来软件包、构建环境管理以及补丁和变更的检查方法的指南。同时，手册还涵盖了软件包构建过程中需要注意的事项，如环境变量配置、二进制包的测试和上传准备。

AI总结

《Debian 新维护者手册》主要内容总结如下：

### 1. 初始化外源 Debian 软件包
- 使用 `dh_make` 命令初始化外源 Debian 软件包，创建必要的 `debian` 目录和模板文件。

  $ dh_make -f ../gentoo-0.9.12.tar.gz

- 初始化过程会创建 `gentoo_0.9.12.orig.tar.gz` 和 `debian.tar.gz` 文件，分别用于存储上游源码和 Debian 打包信息。
- `debian` 目录中包含多个模板文件，用于后续的打包过程。

### 2. 软件包构建工具
- **命令层级**：
- `debian/rules`：软件包构建过程的核心脚本。
- `dpkg-buildpackage`：构建软件包的核心工具。
- `debuild`：集成了 `dpkg-buildpackage` 和 `lintian`，在干净环境中构建。
- `pbuilder`、`pdebuild`、`cowbuilder`、`git-pbuilder`：用于在 chroot 环境中构建软件包。
- `gbp`：在 Git 仓库中管理 Debian 源码，结合 `pbuilder` 和 `dpkg-buildpackage`。
- **使用建议**：即使使用高级工具，了解低级工具（如 `debian/rules` 和 `dpkg-buildpackage`）的工作原理非常重要。

### 3. 补丁管理
- 使用 `dquilt`（`quilt` 的替代品）管理补丁：

  $ dquilt import ../foo.patch
  $ dquilt push
  $ dquilt refresh
  $ dquilt header -e

- 补丁必须有清晰的边界，可以通过以下命令验证：

  $ dquilt pop -a; while quilt push; do quilt refresh; done

### 4. 文件检查
- 使用 `debdiff` 比较两个 Debian 源代码包或二进制包：

  $ debdiff old-package.dsc new-package.dsc

- 使用 `interdiff` 比较两个 `diff.gz` 文件：

  $ interdiff -z old-package.diff.gz new-package.diff.gz

- 使用 `mc` 文件管理器查看 `.deb`、`.udeb`、`.debian.tar.gz` 等文件的内容。

### 5. 开发文档
- **必须阅读的文档**：
- `debian-policy`：Debian Policy Manual，描述软件包进入官方仓库的条件。
- `developers-reference`：Debian 开发者参考，包含详细的打包技术和最佳实践。
- **重要文档**：
- `Autotools Tutorial`：介绍 Autoconf、Automake、Libtool 和 gettext。
- `gnu-standards`：包含 GNU 编码标准和维护者信息。

### 6. 求助渠道
- 优先阅读相关软件包的文档、命令手册 (`man` 和 `info` 页面)。
- 参考邮件列表存档：
- `[e-mail]`
- `[e-mail]`

### 总结
《Debian 新维护者手册》系统地介绍了 Debian 软件包的初始化、构建工具、补丁管理和文档资源，是新手学习 Debian 打包的重要参考。