gbp-dch - 云端在线

程序：

您的姓名

gbp-dch - 从 git commit 消息生成 Debian 变更日志

概要

GBP 对的 [ - 版 [ - 帮帮我 [ --详细 [ --颜色=[自动|开|关] [ - 颜色-
方案=配色方案 [ --debian-分支=分店名称 [ --debian-标签=标签格式 [
--上游分支=分店名称 [ --上游标签=标签格式 [ --忽略分支 [
--快照 | - 释放 [ - 汽车 | --因为=提交 [ --新版本=版本 [ --bpo
| --nmu | --质量保证 | - 团队 [ --分布=姓名 [ --强制分配 [
--紧急=水平 [ --[无-]满 [ --[无-]元 [ --meta-closes=错误关闭标签 [
--meta-closes-bugnum=错误编号格式 [ --快照编号=表达 [ - ID-
长度=数 [ --git 日志=git-log-选项 [ --[no-]git-作者 [ --[无-]多维护 ]
[ --[no-]多维护合并 [ --spawn-editor=[总是|快照|发布] [ - 犯罪-
msg =消息格式 [ - 犯罪 [ --自定义=定制文件 ] [路径1 路径2]

商品描述

GBP 对的 读取 git commit 消息并从中生成 Debian 更改日志。 如果不
给出了参数， GBP 对的 从最后标记的 Debian 软件包版本开始到
当前分支的当前提示。 如果最上面部分的分布
Debian/变更日志 is 未发布，更改日志条目将插入此部分。
否则，将创建一个新部分。

If - 汽车 给出 GBP 对的, 尝试猜测更新日志中记录的最后一次 Git 提交
- 这只适用于快照模式。 除此以外， - 自从 可以用来告诉 GBP 对的 at
它应该从 Git 历史记录开始。

附加路径参数可用于限制存储库路径 GBP 对的 容貌
在。 环境 径 至 Debian/ 如果上游使用 Git 和所有 Debian 打包是一个不错的选择
更改仅限于 Debian/ 子目录。 在更复杂的情况下（例如
向后移植），你可以使用 --git日志 进一步限制生成的变更日志条目，
例如通过使用 --git 日志="--author=Foo 酒吧”.

配置

- 版
打印程序版本，即git-buildpackage套件的版本

-v

--详细
详细执行

-h

- 帮帮我 打印帮助并退出

--颜色=[自动|开|关]
是否使用彩色输出。

--配色方案=配色方案
输出中使用的颜色（启用颜色时）。 COLOR_SCHEME 的格式是
' ： ： ： '。 接受数值和颜色名称，
空字段表示默认颜色。 例如， --git-颜色方案='青色：34::'
将在青色中显示调试消息，在蓝色中显示信息消息，在
默认（即红色的警告和错误消息）。

--debian-分支=分店名称
正在开发 Debian 软件包的 Git 存储库中的分支，默认
is 主.

--上游分支=分店名称
从分支确定上游版本。 默认是 上游.

--git-上游标签=标记格式
查找上游版本标签时使用此标签格式，默认为
上游/%(version)s.

--忽略分支
不检查当前分支是否匹配 debian 分支.

--debian-标签=标签格式
使用的标记格式，标记 debian 版本时，默认为 debian/%(版本)s

--因为=提交
开始阅读提交消息 提交.

- 汽车， -a
从快照横幅（或从
如果不存在快照横幅，则为最后一个标签）。

--[无-]元
解析元标记，如 关闭：, 谢谢： 和 Gbp-Dch：. 请参阅下面的元标记。

--meta-关闭=错误关闭标签
要查找哪些元标记以生成关闭错误的更改日志条目。 默认的
是“关闭|LP”以支持 Debian 和 Launchpad。

--meta-closes-bugnum=错误编号格式
应该使用什么正则表达式来解析错误号。 默认是
'(?:bug|issue)?\#?\s?\d+'。 注意：正则表达式应该抑制错误的所有部分
不需要使用“(?:)”的数字，请参阅 Python 正则表达式手册了解详细信息。

示例： --meta-closes-bugnum="(?:bug)?\s*ex-\d+" 将匹配以下所有内容：

可能的文本匹配？ 结果
------------- ------ ------
错误 EX-12345 Y EX-12345
ex-01273 是 ex-01273
错误 ex-1ab Y ex-1
EX--12345 N

--[无-]满
在更改日志输出中包含完整的提交消息。

--快照， -S
创建快照发布条目。 这会添加一个快照版本号和一个警告
更改日志条目的横幅。 发布版本号正在自动递增
每一个新的快照发布，以避免在快照期间包降级
测试。

--快照编号=表达
将 eval() 转换为新快照编号的 Python 表达式。

- 释放， -R
删除任何快照发布横幅和版本后缀，设置当前
分发到 不稳定，并打开变更日志进行最终调整。

--新版本=版本, -N 版本
添加带有版本的新变更日志部分 新版本。 和...一起 --快照是，
快照编号将附加到 新版本.

- 团队 创建团队上传更改日志条目。

--bpo 增加上传到 backports 的 Debian 版本号，并添加一个 backport
上传变更日志评论。

--nmu 为非维护者上传增加 Debian 版本号。

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

--分布=姓名
将分布字段设置为 姓名.

--强制分配
强制指定的分布 - 分配 被使用，即使它没有
匹配已知分布的列表。

--紧急=水平
将紧急字段设置为 水平.

--git 日志=git-log-选项
选项逐字传递给 混帐日志（1）。

--id-长度=N
包括 N 更改日志条目中提交 ID 的数字。 默认不包含
任何提交 ID。

--忽略正则表达式=正则表达式
忽略提交行匹配 正则表达式 生成变更日志时。

--git-作者
使用 user.name 和 user.email 来自 混帐配置(1) 用于变更日志预告片。

--[no-]多维护合并
由维护者合并提交。

--spawn-editor=[总是|快照|发布]
是否生成编辑器：总是，在做快照或发布时。

--提交消息=消息格式
提交生成的文件时，将此格式字符串用于提交消息
更改日志文件（当 - 犯罪 给出）。 默认是 更新 更新日志
%(版本)s 释放

- 犯罪
提交生成的变更日志。

--自定义=定制文件
从中加载 Python 代码 定制文件. 目前，唯一有用的东西是
代码可以做的是定义一个自定义的 format_changelog_entry() 函数。

快照 MODE

快照模式可用于快速测试和安装周期而无需担心
版本号或更改日志条目。

使用时 --快照 or -S, GBP 对的 在 Debian 更新日志中使用伪头文件
记住最后一次 git commit 它添加了一个更改日志条目。 它还设置了一个版本号
结束于 ~ 。英镑. 它会自动增加快照
后续调用的编号 GBP 对的 -S 以便以后的快照自动具有
更高的版本号。 要离开快照模式，请调用 GBP 对的 与 - 释放 选项。
这将删除伪标头并解开版本号，以便发布版本
具有比快照更高的版本号。

目标 标签

除了上述选项之外，提交消息的格式 Debian/变更日志
可以通过 git commit 消息中给出的特殊标签（称为元标签）进行修改。 元
标签处理可以通过 --元 选项。 标签必须从第一个开始
提交消息的列，但可以出现在任何行上。 它们的形式 标签名称:
折扣值. 有效的元标签是：

Gbp-Dch： 行动
支持的操作是： 忽略 生成时将忽略此提交
Debian/变更日志, 短 这将只使用描述（第一行）
生成更改日志条目时提交消息（当 - 满的 给出），
和 是 这将在生成更改日志条目时使用完整的提交消息
（有用的时候 - 满的 没有给出）。

此外 英镑-Dch，弃用的 git-dch 仍然支持。

谢谢： 味精
在提交消息后添加感谢消息。

关闭： 错误编号
在 Debian/变更日志 该错误已被此提交关闭。 见
--元关闭 关于如何将其扩展到其他错误跟踪器。

以下 git commit 消息：

文档元标记

所以人们不必查阅手册

Gbp-Dch：短
关闭：#636088
感谢：Raphaël Hertzog 的建议

结果在这 Debian/变更日志 入口：

* 文档元标记。
感谢 Raphaël Hertzog 的建议（关闭：#636088）

配置 FILES

几个 配置文件 文件被解析以设置上述命令行参数的默认值。
查看 配置文件(5)> 联机帮助页了解详细信息。

使用 onworks.net 服务在线使用 gbp-dch