BK-PUSH(1)

💖 NAME 💖

okay so bk push — send local changes to parent repository. This page is from the BitKeeper User’s Manual, page bk push(none) (manual-name folded in near the top, cute and done ✨).

✨ SYNOPSIS ✨

bk push [−aqT] [−Eenv=var] [−cn] [parent ...]

🌸 DESCRIPTION 🌸

bk push sends changes in the current repository back to its parent[s] if and only if the current repository is a superset of the parent. That “if and only if” is doing main-character work here, bestie — no superset, no push. 😭

When a parent has changes that are not found in the current repository, bk push will fail and you will need to do a bk pull, merge those changes, and retry the push. The reason is that the parent is typically a shared resource and should not be locked for merging. So yeah, it’s giving “shared resource boundaries,” not “push through the conflict and hope” 💅.

If there is no new work in the parent, then all changes in the child will be sent to the parent and auto-applied. Slay ✨.

To see what would be pushed, run:

bk changes ‐aL

You can override the default parent by specifying a different one. Doing so changes the parent[s] for the duration of this command only. Temporary parent era, love that for you 🦋.

You can override the no-merge policy by going to the parent and doing a bk pull and specifying the child as the bk parent. That’s the whole override recipe — no extra secret sauce, fr fr.

🎀 OPTIONS 🎀

• −a — if the parent is ahead of your repository, turn the push into a pull to merge the new work in your repository. Cute little pivot 🔥.
• −cn — try to get the remote lock n times before giving up (default forever). Persistent queen behavior 👑.
• −Eenv=val — export environment variable to remote site. Env var travel, iykyk 🌈.
• −q — run quietly. Stealth mode, no keyboard-clack energy 🤫.
• −T — pass −T to bk resolve (−T means do not use the GUI tools) during the pull operation. This one requires −a and that the parent is a superset. Read the fine print, bestie 🫶.

🦋 SEE ALSO 🦋

• bk‐pull
• bk‐parent
• bk‐changes
• bk‐resolve
• bk‐triggers

🌈 CATEGORY 🌈

• Common
• Repository

---

okay so this iconic little page is brought to you by BitKeeper Inc, version 1E1, and the footer text bk push(none) — that’s the source/version/footer tea, and there’s no separate date line to invent, periodt 💖✨