Warning

The product is in closed beta and not open to the public.

rm

vb rm|delete|forget FILE1 [FILE2 ...]

Description

Remove one or more files or directories from the repository.

The rm and delete commands do NOT normally remove the files from disk. They just mark the files as no longer being part of the project. In other words, future changes to the named files will not be versioned. However, the default behavior of this command may be overridden via the command line options listed below and/or the mv-rm-files setting.

The forget command never removes files from 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 removed from disk as well. This does NOT apply to the forget command.

Options

--soft

Skip removing files from the check-out. This supersedes the --hard option.

--hard

Remove files from the check-out

--case-sensitive BOOL

Override the case-sensitive setting

-n, --dry-run

If given, display instead of run actions.

--reset

Reset the DELETED state of a check-out, such that all newly-rm’d (but not yet committed) files are no longer removed. No flags other than --verbose or --dry-run may be used with --reset.

--lock

Lock all affected files before deleting them.

--unlock

Unlock all affected files after deleting them. Cannot be used with –lock.

-v, --verbose

Outputs information about each --reset file. Only usable with --reset.

Examples

  • Init and open a repository

$ vb init rm_repo.vbyte
project-id: 5b31d9e026a591ec3daac606305fa882633d5dfa
server-id:  4b609f3225ce4000db299ea0b3bad8ae4c0ddd22
admin-user: frankli (initial remote-access password is "XLEr9JuTsw")
$ vb open -f rm_repo.vbyte
project-name: <unnamed>
repository:   <EXAMPLE>/rm_repo/rm_repo.vbyte
local-root:   <EXAMPLE>/rm_repo/
config-db:    <EXAMPLE>/SOFTBRIDGE/__vbglobal__
project-code: 5b31d9e026a591ec3daac606305fa882633d5dfa
checkout:     5c51a53647c7c0a53071ff29de2fb7896583d95e 2026-11-19 02:31:19 UTC
tags:         trunk
comment:      initial empty check-in (user: frankli)
check-ins:    1
  • Add and commit a file

$ vb system echo "config" > config.tmp
$ vb add config.tmp
ADDED  config.tmp
$ vb ci -m "Add config"
Committed version: 1bb4ff3cf317d17d1970330856ac783865664865776191bcac3ea5f246167366
  • Remove the file from version control

$ vb rm config.tmp
DELETED config.tmp
  • Show changes (DELETED) and commit

$ vb changes
DELETED    config.tmp
$ vb ci -m "Remove config"
Committed version: fb4bc86b48342c9227c3f8e5fab39ad23047de6dceb864b747ef032a8d35f5aa

See Also

See also

addremove, add