bk-renametool - (unknown subject)
NAME
bk renametool − graphical tool for finding renames
SYNOPSIS
bk renametool < filelist
DESCRIPTION
The bk renametool command is a graphical interface
for finding renames. bk renametool is invoked
automatically by the bk import command when importing
patches.
The purpose of this tool is to maintain revision history across file renames. A repository which is managed entirely by BitKeeper manages revision history across file renames. However, a system managed by BitKeeper, but which imports traditional patches (i.e. diff −Nur). needs some help because patches do not directly record renames.
Conceptually, a patch rename is seen as a deletion of one file and a creation of another file. When BitKeeper imports a patch, it detects the set of created and deleted files. These files are then fed to bk renametool where you are given the chance to find files which are actually renames and record that information.
When bk renametool starts up, you are looking at several text windows. The goal is to match up files in the create window with files in the delete window. You can click on files in each window and the tool will show you diffs. When you find two files which you think are the same, you can click the rename button to rename them and remove them from the lists. The guess button tries to find matches for you, based on the basename of the files. When you click on a created file, the guess button is invoked once automatically. You can click on the guess button again to find the next potential match.
After you have matched up every file there is to match up, click create all and delete all to finish up any stragglers, and then click apply.
BINDINGS
Home Scroll both diff windows to the top
End Scroll both diff windows to the bottom
PageUp Scroll both diff windows one screen up
PageDown Scroll both diff windows one screen down
UpArrow Scroll both diff windows one line up
DownArrow Scroll both diff windows one line down
LeftArrow Scroll both diff windows to the left
RightArrow Scroll both diff windows to the right
These bindings
are the same as clicking the associated buttons:
SPACE , n Next diff
a Apply the actions in the Resolved files window
C Create all files in the Created files window
c Create the highlighted file in the Created files
window
D Delete all files in the Deleted files window
d Delete the highlighted file in the Deleted files
window
g Guess what the match might be
h Show history of the highlighted file in the Deleted
files window
p Previous diff
Control−q Quit without applying any changes
r Rename the two marked files
u Undo the highlighted file in the Resolved files
window
SEE ALSO
bk-config-gui, bk-renames
CATEGORY
GUI-tools