bk renametool(7.3ce)        BitKeeper User's Manual       bk renametool(7.3ce)

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 Bit-
       Keeper, 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 actu-
       ally 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 "cre-
       ate 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

BitKeeper Inc                         1E1                 bk renametool(7.3ce)