bk mv(7.3ce) BitKeeper User's Manual bk mv(7.3ce)
NAME
bk mv - rename file[s]
SYNOPSIS
bk mv [-f] <source-file-or-dir> [<file> ...] <dest-file-or-dir>
DESCRIPTION
To rename a file/directory from <A> to <B> do this:
$ bk mv A B
The bk mv command will rename the checked out file (if any) as well as
the revision control file. Edited files are also renamed and then re-
edited, preserving any changes made but not yet checked in. The rename
will appear as an additional change to the file when you commit the
next changeset.
Renames propagate just like content changes, i.e., they happen automat-
ically when you pull changes into your repository from another reposi-
tory unless you have also renamed the file. In that case, the resolver
will prompt you to choose a name.
If the last argument is an existing directory, bk mv moves all listed
files into that directory. Otherwise, if only two files are given, it
renames the first as the second. It is an error if more than two files
are listed and the last argument is not a directory. The intent is
that bk mv behaves like the traditional UNIX mv command, except that it
knows about the additional BitKeeper files and records the rename
event.
NOTES
bk mv will refuse to move BitKeeper metafiles without the -f option
(use of which is not recommended).
If both the <A> and <B> arguments are directories, bk mv will check the
repository consistency. If this check fails the move operation will
not continue.
SEE ALSO
bk commit
bk names
bk pull
bk push
bk rm
bk rmdir
CATEGORY
Common
File
BitKeeper Inc 1E1 bk mv(7.3ce)