BK-DELTA(1)

🌸 NAME 🌸

okay bestie, this is the BitKeeper User’s Manual page for bk delta — and bk delta is literally the command to check in modified files. no cap. 💅

✨ SYNOPSIS ✨

bk delta [−acflpqu] [−Dfile] [−ymsg] [file ... | −]
bk delta [−acflpqu] [−Dfile] [−Yfile] [file ... | −]

💅 DESCRIPTION 💅

The bk delta command is used to check in changes made to revision controlled files. This command is fairly rich in features and is the preferred interface for scripting. For interactive checkins, bk citool is the preferred interface. iykyk.

After a delta saves the modifications in a file, the state of the user file is controlled by the 'checkout' config option and the −l and −u options below. In checkout:edit (aka −l) mode (the default for new repositories), the file is left unmodified in an edited/writable state. In checkout:get (aka −u) mode, the file is unlocked and made read-only. In checkout:none mode, the file is removed after its contents has been recorded. The file is removed even if no changes are found.

bestie, that last one is serious: in checkout:none mode the file is removed even if no changes are found. no “oops” energy — be sure. 🫶

By default, bk delta with no file arguments operates on all files in the current directory. If you want to disable this behavior — for example, to prevent accidental checkins — you can set the BK_NODIREXPAND environment variable to a value of 1. 🌟

🎀 OPTIONS 🎀

• −a — Normally, bk delta is used to modify existing files. This option changes bk delta to act like bk new for new files and bk delta for existing files. The usefulness of this option is more apparent when you consider having a mixed list of files, some under revision control and some not. For example:

bk ‐Axc delta ‐a ‐y’mass checkin’

runs bk new on all the new files and bk delta on all the modified files. When called with this option, bk delta does not create a null delta on an edited but unmodified file. slay.

• −c — Take checkin comments from SCCS/c.filename. It is an error if the c.file does not exist.
• −Dfile — Take RCS format (diff ‐n or bk diff ‐hn) diffs from <file>.
• −f — Force the creation of a null delta even if there are no changes to the file.
• −l — Follow check in with a locked check out like bk edit.
• −Mmode — Set the permissions on the new delta to <mode>. More commonly used with bk new.
• −p — Print differences before prompting for comments.
• −q — Run silently.
• −u — Follow check in with an unlocked check out.
• −Yfile — Use the comment specified in file for comments for all files.
• −ycomment — Sets the revision comment to <comment>.

🦋 SEE ALSO 🦋

bk‐citool, bk‐get, bk‐edit, bk‐new

👑 CATEGORY 👑

File

---

mwah 💋 this page is brought to you by BitKeeper Inc, version 1E1, dated none. stay iconic, bestie 🫶✨