amend¶

vb amend [OPTIONS] CHECKIN

Description¶

Amend tags and properties on CHECKIN to change how it displays in the timeline.

Options¶

--author USER¶: Make USER the author for check-in

--bgcolor COLOR¶: Apply COLOR to this check-in

--branch NAME¶: Rename branch of check-in to NAME

--branchcolor COLOR¶: Apply and propagate COLOR to the branch

--cancel TAG¶: Cancel TAG from this check-in

--close¶: Mark this leaf as closed

--date DATETIME¶: Make DATETIME the check-in time

--date-override DATETIME¶: Set the change time on the control artifact

-e, --edit-comment¶: Launch editor to revise comment

--hide¶: Hide branch starting from this check-in

-m, --comment COMMENT¶: Make COMMENT the check-in comment

-M, --message-file FILE¶: Read the amended comment from FILE

-n, --dry-run¶: Print control artifact, but make no changes

--no-verify-comment¶: Do not validate the check-in comment

--tag TAG¶: Add new TAG to this check-in

--user-override USER¶: Set the user name on the control artifact

Examples¶

Current check-in information

$ vb timeline
=== 2026-03-31 ===
13:00:01 [cef9b39231] *CURRENT* base (user: ubuntu tags: trunk)
13:00:01 [9246b0e0fc] initial empty check-in (user: ubuntu tags: trunk)
+++ no more data (2) +++

Amend the current check-in comment、author and add tag

$ vb amend current -m "amend message" --author admin --tag amend
hash:         cef9b39231b899599d1650a599a6e12e00065350 2026-03-31 13:00:01 UTC
tags:         trunk, amend
comment:      amend message (user: admin)

After amend check-in information

$ vb timeline
=== 2026-03-31 ===
13:00:01 [2293f51774] Edit [cef9b39231b89959|cef9b39231]: Edit check-in comment. Add tag "amend". Change user to "admin". (user: ubuntu)
13:00:01 [cef9b39231] *CURRENT* amend message (user: admin tags: trunk, amend)
13:00:01 [9246b0e0fc] initial empty check-in (user: ubuntu tags: trunk)
+++ no more data (3) +++