BK-RENAMETOOL(1)

Okay bestie, welcome to bk renametool — straight outta the BitKeeper User’s Manual — the graphical tool for finding renames. It’s giving “tiny detective UI for your patch” and I’m obsessed. ✨

💖 NAME 💖

bk renametool — graphical tool for finding renames. No cap, that’s the whole vibe. 🎀

🌈 SYNOPSIS 🌈

bk renametool < filelist

🦋 DESCRIPTION 🦋

The bk renametool command is a graphical interface for finding renames. It gets invoked automatically by the bk import command when you’re importing patches. 🫶

The purpose of this tool is to maintain revision history across file renames. A repository managed entirely by BitKeeper manages revision history across file renames. But a system managed by BitKeeper that imports traditional patches (i.e. diff −Nur) needs a little 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. Those files are then fed to bk renametool, where you get the chance to find files that are actually renames and record that information. Literally matchmaking for files. 💅

When bk renametool starts up, you’re 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 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’ve matched up every file there is to match up, click create all and delete all to finish up any stragglers, and then click apply. Slay. ✅

🎀 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 — that’s the category, periodt. 💜

Cute sign-off: brought to you by BitKeeper Inc, footer tag 1E1, page bk renametool(none) — byeee bestie 💖🦋