tag¶
标签和属性设置。
vb tag SUBCOMMAND...
示例¶
列出所有标签
$ vb tag ls
japan
layla
trunk
v2.0
zds
说明¶
运行各种子命令来控制标签和属性,标签可用于标记仓库历史记录中的特定点。
选项 --raw
允许操作 VisionByte 中用于各种内部用途的所有类型的标签。
它还显示 find
和 list
子命令的 cancel
标签。
如果使用了可能与十六进制基线或工程 ID 混淆的标记名,则可以在其前面加上 tag:
来明确消除歧义。例如:
vb update decaf
将被视为工程或基线 ID,而 visionbyte 可能会没有找到这样的修订。然而
vb update tag:decaf
此命令假定 decaf
是一个标签/分支名称。
子命令¶
add¶
vb tag add [OPTIONS] TAGNAME ARTIFACT-ID [VALUE]
向指定的工程添加新标签或属性。ARTIFACT-ID 参数是需要添加标签的工程的哈希值。
对于签入,该标签可用于更新和合并等命令中,而不是 CHECK-IN。
选项¶
|
设置添加的日期时间 |
|
试运行,不执行任何操作,但显示将发生的情况。 |
|
向后代传播标签 |
|
显示原始标签名称。非 CHECK-IN 工程将被忽略 |
|
添加标签时指定用户 |
--date-override
和 --user-override
选项支持从其他 SCM 系统导入历史记录。DATETIME 的格式为 YYYY-MMM-DD HH:MM:SS
。
如果存在 --propagate
选项,并且工程引用 Wiki 页面、论坛帖子、技术说明或签入,则该标签将传播到该工程的所有后代。
备注
VisionByte 内部会使用一些标签前缀,以避免引起问题或混淆,此命令将禁止与: wiki-
、tkt-
、 event-
这些前缀标签共用。
cancel¶
vb tag cancel [OPTIONS] TAGNAME ARTIFACT-ID
删除指定的工程中标签,并删除该标签向后代的所有传播。禁止与 wiki-
、tkt-
、 event-
标签共用。
选项¶
|
设置删除的日期时间 |
|
试运行,不执行任何操作,但显示将发生的情况。 |
|
显示原始标签名称。非 CHECK-IN 的工程将被忽略。 |
|
添加标签时指定用户 |
find¶
vb tag find [OPTIONS] TAGNAME
列出所有指定标签名的工程。
选项¶
|
限制输出 N 个结果 |
|
将标签设置为主干名 |
|
仅输出指定类型的项目,例如: |
list|ls¶
vb tag list|ls [OPTIONS] [ARTIFACT-ID]
列出所有标签,如果指定了工程,则列出该工程的所有标签及其值。
标签类型:propagated
、 singleton
、cancel
。
为了兼容历史脚本,除非使用 --raw
或 --prefix
选项,否则默认会省略内部标签类型 wiki-
、 tkt-
和 event-(technote)
。
选项¶
|
列出标签的原始名称 |
|
仅列出具有给定前缀的标签。 VisionByte 内部前缀包括 |
|
仅列出指定类型的项目: |
|
与 |
|
使用连接值时的分隔器 |
|
列出标签值,如果提供了 |