mv¶
vb mv|rename OLDNAME NEWNAME
vb mv|rename OLDNAME ... DIR
Description¶
Move or rename one or more files or directories within the repository tree. You can either rename a file or directory or move it to another subdirectory.
The mv command does NOT normally rename or move the files on disk. This command merely records the fact that file names have changed so that appropriate notations can be made at the next commit. However, the default behavior of this command may be overridden via command line options listed below and/or the mv-rm-files setting.
The rename command never renames or moves files on disk, even when the command line options and/or the mv-rm-files setting would otherwise require it to do so.
WARNING: If the --hard option is specified -OR- the mv-rm-files
setting is non-zero, files WILL BE renamed or moved on disk
as well. This does NOT apply to the rename command.
Options¶
- --hard¶
Move files within the check-out
- --case-sensitive BOOL¶
Override the case-sensitive setting
- -n, --dry-run¶
If given, display instead of run actions
Examples¶
Init and open a repository
$ vb init mv_repo.vbyte
project-id: 49c588ecba862d4e378c009492647828efbc0f10
server-id: 72328ac56b4c0c1f14da01733c3dad1e50b89f21
admin-user: ubuntu (initial remote-access password is "2HU7NYtiGk")
$ vb open -f mv_repo.vbyte
project-name: <unnamed>
repository: /tmp/sphinx_tests/d7e31b3b/mv_repo/mv_repo.vbyte
local-root: /tmp/sphinx_tests/d7e31b3b/mv_repo/
config-db: /tmp/sphinx_tests/d7e31b3b/.visionbyte
project-code: 49c588ecba862d4e378c009492647828efbc0f10
checkout: 15f7efa142a03ba02816738b73b2ce818297d335 2026-03-25 02:48:01 UTC
tags: trunk
comment: initial empty check-in (user: ubuntu)
check-ins: 1
Create and commit a file
$ vb sys echo "data" > oldname.txt
$ vb add oldname.txt
ADDED oldname.txt
$ vb ci -m "Initial"
Committed version: 4aa04ef862ca36816893bdc3441f7fd588677cf3b0d8a3533c76af692945311c
Rename the file(default not renames or moves files on disk)
$ vb sys mv oldname.txt newname.txt
$ vb mv oldname.txt newname.txt
RENAME oldname.txt newname.txt
$ vb changes
RENAMED oldname.txt -> newname.txt