debchange - 云端在线

程序：

您的姓名

debchange - 用于维护源包中 debian/changelog 文件的工具

概要

债务 [选项[文本 ...]
对的 [选项[文本 ...]

商品描述

债务 或其别名 对的 将在 Debian 更改日志中添加一个新的注释行
当前源树。 此命令必须从该树中运行。 如果文本
在命令行上给出更改， 债务 将以批处理模式运行，只需添加
文本，根据需要在适当的位置换行 Debian/变更日志 （或
由选项指定的更改日志，如下所述）。 如果未指定文本，则
债务 将运行由确定的编辑器 明智的编辑 供您编辑文件。
（环境变量 VISUAL 和 EDITOR 按此顺序使用以确定哪个
要使用的编辑器。）了解 +n 开始编辑的选项
指定的行将使用它移动到文件的正确行进行编辑。 如果
编辑器退出而不修改临时文件， 债务 将退出而不触摸
现有的变更日志。 备注 这 此 更新日志 is 假定 至 be 编码 此 UTF-8
编码。 If it is 不， 问题 五月 发生。 请参阅 的iconv(1) 联机帮助页找出
如何从旧编码转换变更日志。 最后，一个 更新日志 or 新闻中心 文件可以是
使用 - 创建 选项如下所述。

债务 还支持自动生成错误关闭更改日志条目，使用
--关闭 选项。 这通常会查询 BTS，即 Debian 错误跟踪系统（参见
https://bugs.debian.org/) to determine the title of the bug and the package in which it
发生。 这种行为可以通过给出一个 --noquery 选项或通过设置
配置变量 DEBCHANGE_QUERY_BTS 至 没有，如下所述。 在任何一种情况下，
编辑器（如上所述）将始终被调用以提供修改
条目，并且无论是否进行修改，更改日志都将被接受。 一个
除了关闭条目之外，还可以在命令行上提供额外的更改日志条目。

至多其中之一 - 附加, - 增量, - 编辑, - 释放及 - 新版本 可以指定
如下所列。 如果没有指定选项， 债务 将使用启发式来猜测
包是否已成功发布，并表现得好像 - 增量
已指定包是否已发布，否则就好像 - 附加 一直
指定的。

可以使用两组不同的启发式方法，由 --release-启发式
选项还是 DEBCHANGE_RELEASE_HEURISTIC 配置变量。 默认的 更新日志
启发式假设包已经发布，除非它的更新日志包含 未发布
在分销领域。 如果启用此启发式，则分发将默认
至 未发布 在新的变更日志条目中，以及 --维护拖车 下面描述的选项将
被自动启用。 如果一个包可以由不同的人发布，这会很有用
维护者，或者如果您不保留上传日志。 候补 日志 启发式确定
如果一个包已经通过寻找合适的 上传（1）或 输出(1) 日志
父目录中的文件。 如果找到了日志文件但是一个警告将发出
成功上传不记录。 这可能是因为执行了之前的上传
有一个版本 上传 在 2.1 之前或因为上传失败。

如果有 - 增量 or - 新版本 使用，新版本的名称和电子邮件将
确定如下。 如果环境变量 全名 已设置，这将是
用于维护者全名； 如果没有，那么 您的姓名 将被检查。 如果环境
变量 电子邮件 设置后，这将用于电子邮件地址。 如果这个变量有
形式“名称"，那么维护者名称也将从这里获取，如果两者都不是
全名 也不 您的姓名 设置。 如果未设置此变量，则对
环境变量 邮箱地址. 接下来，如果还没有确定全名，
然后用 获取数据(3)从密码文件中确定名称。 如果失败，请使用
以前的变更日志条目。 对于电子邮件地址，如果尚未从 电子邮件 or
邮箱地址，然后往里看 /etc/邮件名，然后尝试从用户名和 FQDN 构建它，
否则使用上一个更改日志条目中的电子邮件地址。 换句话说，它是一个
设置的好主意 电子邮件 和 全名 使用此脚本时。

包括对记录多个共同维护者更改的更改日志的支持
包裹。 如果一个条目被附加到当前版本的条目，并且维护者是
不同于被列为已完成先前条目的维护者，则
行将添加到更改日志中以告知哪些维护者进行了哪些更改。
目前仅支持多种此类记录此信息的样式中的一种，
其中进行了一组更改的维护者的姓名出现在
变化，在方括号内。 这可以打开和关闭使用
--[没有]多维 选项还是 DEBCANGE_MULTIMAINT 配置文件选项； 默认的
是启用它。 请注意，如果一个条目已经以这种方式被标记，那么这个
选项将被默默忽略。

如果源树的目录名称具有以下形式 包-版本， 然后 债务 将
如果（上游）版本号发生变化，也尝试重命名它。 这是可以防止的
通过使用 - 保留 命令行或配置文件选项，如下所述。

If --force-bad-版本 or --允许较低版本 用来， 债务 不会停止，如果
新版本小于当前版本。 这在做的时候特别有用
向后移植。

目录 姓名 检查

与其他几个脚本相同 文字 包， 债务 会爬上
目录树，直到它找到一个 Debian/变更日志 文件。 作为防止杂散文件的保护措施
导致潜在问题，一旦找到，它会检查父目录的名称
此 Debian/变更日志 文件，并检查目录名是否与包对应
姓名。 确切地说，这是由两个配置文件变量控制的
DEVSCRIPTS_CHECK_DIRNAME_LEVEL 和 DEVSCRIPTS_CHECK_DIRNAME_REGEX，以及它们对应的
命令行选项 --检查目录名级别 和 --check-dirname-正则表达式.

DEVSCRIPTS_CHECK_DIRNAME_LEVEL 可以采用以下值：

0 永远不要检查目录名称。

1 如果我们必须在搜索中更改目录，则仅检查目录名称
Debian/变更日志. 这是默认行为。

2 始终检查目录名称。

通过测试当前目录名（如确定的
by PWD(1)) 匹配配置文件选项给出的正则表达式
DEVSCRIPTS_CHECK_DIRNAME_REGEX 或通过命令行选项 --check-dirname-正则表达式 正则表达式.
这里 正则表达式 是一个 Perl 正则表达式（见 珍珠(3perl)), 开头会锚定
和结束。 如果 正则表达式 包含一个 '/'，那么它必须匹配完整的目录路径。 如果
不是，那么它必须匹配完整的目录名称。 如果 正则表达式 包含字符串´包',
这将被源包名称替换，根据更改日志确定。 这
正则表达式的默认值是：´包（-.+）？'，从而匹配目录名称，例如
包 和 包裹-版本.

要编辑的默认更改日志是 Debian/变更日志; 但是，这可以使用
此 --变更日志 or - 消息 选项或 CHANGELOG 环境变量，如描述
联络一位教师

配置

- 附加, -a
在当前版本条目的末尾添加一个新的变更日志条目。

- 增量, -i
增加 Debian 版本号的最后一个组件，或者，如果这是一个
本机 Debian 软件包，版本号。 在 Ubuntu 或 Tanglu 上，这也将
将后缀从 buildX 更改为 ubuntu1/tanglu1。 用 -R, - 重建 不
更改重建增量。 这将在开头创建一个新部分
带有适当的页眉和页脚的变更日志。 另外，如果这是新版本
一个本机 Debian 软件包，目录名称已更改以反映这一点。 如果
DEBCHANGE_RELEASE_HEURISTIC is 更新日志 （默认），当前版本是
未发布，这只会更改当前更改日志节的版本。
否则，这将使用新版本创建一个新的变更日志节。

- 新版本 版本, -v 版本
这明确指定了版本号（包括 Debian 发行版部分）
并表现为 - 增量 其他方面的选择。 也将改变
如果上游版本号已更改，则目录名称。 如果
DEBCHANGE_RELEASE_HEURISTIC is 更新日志 （默认），当前版本是
未发布，这只会更改当前更改日志节的版本。
否则，这将使用新版本创建一个新的变更日志节。

- 编辑, -e
在编辑器中编辑变更日志。

- 释放, -r
完成版本的变更日志。 更新变更日志时间戳。 如果
分布设置为 未发布, 改成之前的分布
更改日志条目（或由 - 分配）。 如果有
没有以前的变更日志条目，也没有明确的分发
指定的， 不稳定 将被使用。

--释放时强制保存
什么时候 - 释放 使用时，将打开一个编辑器以允许检查更改日志。
用户需要保存文件才能接受修改后的变更日志，否则
将保留原件（默认）。

--释放时不强制保存
不要这样做。 请注意，可能会提供一个虚拟的变更日志条目以实现
相同的效果 - 例如 债务 - 释放 "". 该条目将不会添加到
更改日志，但它的存在会抑制编辑器。

- 创建
这将创建一个新的 Debian/变更日志 文件（或 新闻中心 如果 - 消息 选项是
用过的）。 您必须在顶级目录中才能使用它； 没有目录名
将进行检查。 可以指定包名称和版本
使用 - 包裹 和 - 新版本 选项，根据目录名称确定
使用 --from目录名 选项或手动输入到生成的 更新日志
文件。 如果可能，维护者名称由环境确定，
并且使用指定的分布 - 分配 选项或在
产生 更新日志 文件中。

- 空的
结合使用时 - 创建, 抑制自动添加
"初始 释放" 更改日志条目（以便下次调用 债务 增加
第一个条目）。 请注意，这将导致 dpkg-解析更改日志 警告
由于缺少更改，下次调用。

- 包裹 包
这指定了要在新更改日志中使用的包名称； 这可能只是
与 - 创建, - 增量 和 - 新版本 选项​​。

--nmu, -n
通过附加任何一个来增加非维护者上传的 Debian 版本号
一个 ”.1" 到非 NMU 版本号（除非软件包是 Debian 原生的，其中
案件 ”+纳米1" 附加）或通过增加 NMU 版本号，并添加 NMU
更改日志评论。 如果打包程序不在
维护者 也不是 上载者 场在 Debian /控制，除非 DEBCANGE_AUTO_NMU is
设置 没有 或者 --无自动 nmu 选项被使用。

--bin-nmu
通过以下任一方式增加二进制非维护者上传的 Debian 版本号
附加一个“+b1" 到非 binNMU 版本号或通过增加 binNMU
版本号，并添加 binNMU 更改日志注释。

--质量保证, -q
为 Debian QA 团队上传增加 Debian 版本号，并添加一个 QA
上传 更改日志评论。

- 重建, -R
通过附加“build1”来增加 Debian 版本号以进行无更改重建
或者通过增加重建版本号。

- 安全, -s
为 Debian 安全团队非维护者增加 Debian 版本号
上传，并添加一个 安保行业 团队 上传 更改日志评论。

- 团队 增加团队上传的 Debian 版本号，并添加一个 团队 上传
更改日志评论。

- 上游的, -U
不附加 发行版名称 1 到派生发行版上的版本。 增加
Debian 版本。

--bpo 增加上传到 jessie-backports 的 Debian 版本号，并添加一个
向后移植上传更改日志评论。

- 当地的, -l后缀
为本地构建的 Debian 版本号添加后缀。

--force-bad-版本, -b
强制版本号小于当前版本号（例如，在向后移植时）。

--允许较低版本 模式
如果新版本匹配，则允许版本号小于当前版本号
指定的模式。

--强制分配
强制使用提供的分发，即使它与列表不匹配
已知发行版（例如非官方发行版）。

--自动NMU
尝试自动确定对变更日志的更改是否代表
非维护者上传。 这是默认设置。

--无自动 nmu
禁用自动 NMU 检测。 相当于设置 DEBCANGE_AUTO_NMU 至 没有.

--from目录名, -d
这将从目录名称中获取上游版本号，这应该是
的形式 包-版本. 如果上游版本号从
最近的更改日志条目，然后将使用版本号创建一个新条目
版本-1 （或 版本 如果软件包是 Debian 原生的），与
以前的软件包版本。 如果上游版本号相同，则此选项
行为方式与 -i.

--关闭 NNNNN[,NNNNN ...]
添加更改日志条目以关闭指定的错误编号。 也调用编辑器
添加这些条目后。 如果无法联系到 BTS 将产生警告
（和 --noquery 尚未指定），或者是否存在错误问题
报告位于。

--[没有]询问
我们应该在生成关闭条目时尝试查询 BTS 吗？

- 保留, -p
如果上游版本号（或
Debian 本机软件包的版本号）更改。 另见配置
下面的变量部分。

--不保留, --不保留
不保留源树目录名称（默认）。

- 小贩 供应商
覆盖 dpkg-vendor 返回的默认值的经销商 ID。 这个名字是
用于应用于新包版本的启发式方法以及对包的完整性检查
目标分布。

- 分配 DIST, -D DIST
在正在编辑的变更日志条目中使用指定的分布，而不是
对新条目或现有条目使用上一个变更日志条目的分布
现有条目的值。

--紧迫性 急, -u 急
在正在编辑的变更日志条目中使用指定的紧急程度，而不是使用
默认 ”中等" 用于新条目或现有条目的现有值。

--变更日志 文件, -c 文件
这将编辑变更日志 文件 而不是标准 Debian/变更日志。 这
选项覆盖任何 CHANGELOG 环境变量设置。 也没有目录
使用此选项时将执行遍历或检查。

- 消息 [新闻档案]
这将编辑 新闻档案 （默认情况下， Debian/新闻) 而不是常规的变更日志。
将执行目录搜索。 将检查变更日志，以便
确定当前的包版本。

--[没有]多维
我们是否应该指出变更日志条目的某些部分是由不同的
维护者？ 默认为是； 请参阅上面的讨论以及
DEBCANGE_MULTIMAINT 下面的配置文件选项。

--[没有]多维护合并
是否应该将同一作者所做的所有更改合并到同一更改日志中
部分？ 默认为否； 请参阅上面的讨论以及
DEBCHANGE_MULTIMAINT_MERGE 下面的配置文件选项。

--维护维护, -m
不要修改之前在变更日志中列出的维护者详细信息。 这是
对想要自动添加赞助信息的赞助商特别有用
不会中断其他更改日志详细信息。 请注意，可能会有一些
如果使用多维护者模式，有趣的交互； 你可能会希望
在这种情况下，在上传之前手动检查更改日志。

--控制维护, -M
使用维护者详细信息 Debian /控制 维护者 场而不是
相关的环境变量（全名, 电子邮件， 等等。）。 这个选项可能是
在更改日志预告片中恢复主要维护者的详细信息后很有用
虚假编辑（例如，当 -m 是有意但忘记了）或在发布包时
主要维护者的名称（例如团队）。

--[没有]主拖车, -t
If 主拖车 设置，它将避免修改现有的变更日志预告行
（即维护者和日期戳详细信息），除非与需要的选项一起使用
要修改的拖车（例如 - 创建, - 释放, -i, --质量保证等）这个选项
不同于 --维护维护 因为它将在适当的情况下使用多维护者模式，
除了编辑预告片。 另见 DEBCANGE_MAINTTRAILER
下面的配置文件选项。

--检查目录名级别 N
见上节“目录 姓名 检查" 来解释这个选项。

--check-dirname-正则表达式 正则表达式
见上节“目录 姓名 检查" 来解释这个选项。

--无会议, --noconf
不要读取任何配置文件。 这只能用作第一个选项
在命令行中给出。

--release-启发式 日志|更新日志
控制方式 债务 确定包是否已发布，在决定时
是创建新的变更日志条目还是附加到现有的变更日志条目。

- 帮帮我, -h
显示帮助信息并成功退出。

- 版
显示版本和版权信息并成功退出。

配置 变数

两个配置文件 /etc/devscripts.conf 和 〜/.devscripts 来源于
为了设置配置变量。 命令行选项可用于覆盖
配置文件设置。 为此将忽略环境变量设置。
当前识别的变量是：

DEBCANGE_PRESERVE
如果这设置为 含，那么它与 - 保留 命令行参数
正在使用。

DEBCHANGE_QUERY_BTS
如果这设置为 没有，那么它与 --noquery 命令行参数
正在使用。

DEVSCRIPTS_CHECK_DIRNAME_LEVEL, DEVSCRIPTS_CHECK_DIRNAME_REGEX
见上节“目录 姓名 检查" 对这些的解释
变量。 请注意，这些是包范围的配置变量，并将
因此影响所有 文字 检查其值的脚本，如中所述
他们各自的联机帮助页和 开发脚本配置文件（5）。

DEBCHANGE_RELEASE_HEURISTIC
控制方式 债务 确定包是否已发布，在决定时
是创建新的变更日志条目还是附加到现有的变更日志条目。
可以是 日志 or 更新日志.

DEBCANGE_MULTIMAINT
如果设置为 没有, 债务 当一个
不同的维护者将一个条目附加到现有的变更日志中。 见讨论
以上。 默认是 含.

DEBCHANGE_MULTIMAINT_MERGE
如果设置为 含, 在多维护者模式下添加更改时 债务 会检查
当前维护者之前的更改是否存在并将新更改添加到
现有块而不是创建新块。 默认是 没有.

DEBCANGE_MAINTTRAILER
如果这设置为 没有，那么它与 --nomaintrailer 命令行
正在使用的参数。

DEBCCHANGE_TZ
将此时区用于更改日志条目。 默认是用户/系统时区作为
显示为`日期 -R` 并受环境变量影响 TZ.

DEBCHANGE_LOWER_VERSION_PATTERN
如果设置了这个，那么它与 --允许较低版本 命令行
正在使用的参数。

DEBCANGE_AUTO_NMU
如果这设置为 没有 然后 债务 不会尝试自动确定
当前更改日志节是否代表 NMU。 默认是 含。 看
的讨论 --nmu 以上选项。

DEBCHANGE_FORCE_SAVE_ON_RELEASE
如果这设置为 没有，那么它与 --释放时不强制保存 命令
正在使用的线路参数。

DEBCCHANGE_VENDOR
使用此供应商而不是默认值（dpkg-vendor 输出）。 看 - 小贩
细节。

环境

电子邮件, 邮箱地址, 全名, 您的姓名
这些环境变量的使用请看上面的说明。

CHANGELOG
此变量指定要编辑的变更日志代替 Debian/变更日志。 没有
设置此变量时执行目录遍历或检查。 这个
变量被覆盖 --变更日志 命令行设置。

VISUAL, EDITOR
这些环境变量（按此顺序）决定了所使用的编辑器 理智——
编辑.

使用 onworks.net 服务在线使用 debchange