第 1 章 简介

目录

1.1. 报告文档错误
1.2. 贡献升级报告
1.3. 本文档的源文件

本文档告知 Debian 发行版的用户,版本 12(代号 bookworm)发生的主要变化。

本发行说明提供如何安全地从版本 11(代号 bullseye)升级到当前版本的信息,并告知用户在升级过程中可能会遇到的已知的潜在问题。

您可以在 https://www.buy-develop.eu.org/releases/bookworm/releasenotes 获取本文档的最新版本。

[小心]小心

注意列出所有已知的问题是不可能的,因此我们根据影响范围和严重程度选择了一部分问题加以说明。

请注意,我们仅支持从 Debian 的前一版本升级(对于本次发行,即为从 bullseye 升级)并对其提供说明文档。如果您需要从更早的版本升级,我们建议您先查看前一版本的发行说明,并先升级到 bullseye。

1.1. 报告文档错误

我们已尽可能地测试了本文档中描述的所有不同的升级步骤,并预测了用户可能遇到的所有问题。

尽管如此,如果您认为您发现了本文档的任何错误(不正确或者缺失的信息),请在错误追踪系统中向 release-notes 软件包提交错误报告。您可以考虑先浏览一遍已有的错误报告以避免重复报告同一问题。如果您有能力对本文档做出贡献,也欢迎您向现有的错误报告添加额外的信息。

我们鼓励在提交错误报告时提供针对本文档源代码的补丁,并对此表示由衷感谢。您可以在第 1.3 节 “本文档的源文件”中获知如何获取本文档源代码。

1.2. 贡献升级报告

我们欢迎用户提供关于从 bullseye 升级到 bookworm 的任何信息。如果您愿意分享,请在错误追踪系统中向 upgrade-reports 软件包提交包含您的升级结果的错误报告。我们希望您压缩提交的所有附件(使用 gzip)。

当您提交升级报告的时候,请包含以下信息:

  • 在升级前后,软件包数据库的状态:dpkg 的状态数据库在 /var/lib/dpkg/statusapt 的软件包状态信息在 /var/lib/apt/extended_states。您应当在升级之前先根据第 4.1.1 节 “备份数据和配置文件”里的说明进行备份,但您也可以在 /var/backups 中找到 /var/lib/dpkg/status 文件的备份。

  • 使用 script 创建的会话日志,如第 4.4.1 节 “记录会话”所述。

  • apt 的日志 /var/log/apt/term.log,或 aptitude 的日志 /var/log/aptitude

[注意]注意

在提交错误报告之前,您应该花点时间检查和删除日志中的任何敏感和/或机密信息,因为这些信息都会被发布在公开的数据库中。

1.3. 本文档的源文件

本文档的源文件格式是 DocBook XML。HTML 版本使用 docbook-xslxsltproc 生成。PDF 版本使用 dblatexxmlroff 生成。可以从 Debian 文档计划的 Git 仓库获得本发行说明的源文件。您也可以在网页端分别访问这些文件,并查看它们的变更。请参考 Debian 文档计划的版本控制系统信息页面以了解访问 Git 仓库的方法。