tag

标签和属性设置。

vb  tag SUBCOMMAND...

示例

  • 列出所有标签

$ vb tag ls
japan
layla
trunk
v2.0
zds

说明

运行各种子命令来控制标签和属性,标签可用于标记仓库历史记录中的特定点。

选项 --raw 允许操作 VisionByte 中用于各种内部用途的所有类型的标签。 它还显示 findlist 子命令的 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。

选项

--date-override DATETIME

设置添加的日期时间

-n|--dry-run

试运行,不执行任何操作,但显示将发生的情况。

--propagate

向后代传播标签

--raw

显示原始标签名称。非 CHECK-IN 工程将被忽略

--user-override USER

添加标签时指定用户

--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- 标签共用。

选项

--date-override DATETIME

设置删除的日期时间

-n|--dry-run

试运行,不执行任何操作,但显示将发生的情况。

--raw

显示原始标签名称。非 CHECK-IN 的工程将被忽略。

--user-override USER

添加标签时指定用户

find

vb tag find [OPTIONS] TAGNAME

列出所有指定标签名的工程。

选项

-n|--limit N

限制输出 N 个结果

--raw

将标签设置为主干名 trunk 而非分支名,并匹配任何类型的工程。使输出仅包含匹配对象的版本号。

-t|--type TYPE

仅输出指定类型的项目,例如:ci = file commitse = technical notesf = forum postst = ticketsw = wiki commits ,如果和 --raw 共用则忽略。

list|ls

vb tag list|ls [OPTIONS] [ARTIFACT-ID]

列出所有标签,如果指定了工程,则列出该工程的所有标签及其值。

标签类型:propagatedsingletoncancel

为了兼容历史脚本,除非使用 --raw--prefix 选项,否则默认会省略内部标签类型 wiki-tkt-event-(technote)

选项

--raw

列出标签的原始名称

--prefix

仅列出具有给定前缀的标签。 VisionByte 内部前缀包括 sym- (branch name) , wiki- , event- (technote)tkt- (ticket)。若没有使用 --raw 选项,前缀将从结果列表中删除。如果指定了工程,则该选项被忽略。

--tagtype TYPE

仅列出指定类型的项目:cancelsingletonpropagated 的标签

-v|--inverse

--tagtype 含义相反

--sep SEP

使用连接值时的分隔器

--values

列出标签值,如果提供了 --sep,则在同一行上列出标签的所有值,用分隔器分隔;否则在自己的行上列出每个值。