PACKIT-SOURCE-GIT-UPDATE-DIST-GIT(1)

💖 NAME 💖

packit-source-git-update-dist-git — okay so this is the glow-up command that updates a dist-git repository using content… (yes bestie the original really does trail off there, we're keeping it exactly like that, no cap 🫶)

---

✨ SYNOPSIS ✨

packit source-git update-dist-git [OPTIONS] SOURCE_GIT DIST_GIT

---

🦋 DESCRIPTION 🦋

Update a dist-git repository using content from a source-git repository. That's the whole vibe. 💅

More specifically, it updates a dist-git repo with patches created from the commits between <upstream_ref> and the current HEAD of the source-git repo. Iconic behaviour honestly.

So here's the tea, and it's important: this command, by default, performs only local operations and uses the content of the source-git and dist-git repository as it is. It does not checkout branches and it does not fetch remotes. It's giving very much "we stay in our lane, we don't touch the network" energy. 🙈

A commit in dist-git is created only if a commit message is provided with --message or --file. And that commit will have a 'From-source-git-commit' Git-trailer appended to it, to mark the hash of the source-git commit from which it is created. Cute little breadcrumb trail, we love a paper trail. 🎀

The source archives are retrieved from the upstream URLs specified in the spec-file and uploaded to the lookaside cache in dist-git only if

🌸 that sentence genuinely just ends there in the original, bestie — not me finishing it for you, that would be making stuff up, and we don't do that here.

---

🌈 Examples

To update a dist-git repo from source-git without uploading the source-archive to the lookaside cache and without creating a commit with the updates, run:

$ packit source-git update-dist-git src/curl rpms/curl

To also commit the changes and upload the source-archive to the lookaside-cache, specify -m and --pkg-tool:

$ packit source-git update-dist-git -m'Update from source-git'
--pkg-tool fedpkg src/curl rpms/curl

---

👑 OPTIONS 👑

• --upstream-ref TEXT — Git ref of the last upstream commit in the current branch from which packit should generate patches. Heads up: this option implies the repository is source-git. 🧚
• --pkg-tool TEXT — Name or path of the packaging tool used to work with sources in the dist-git repo. A variant of 'rpkg'. Slay. 💜
• Skip retrieving and uploading source archives to the lookaside cache if not specified.

⭐ okay so this one shows up in the manpage with no option name attached — it's just vibing there on its own. Leaving it exactly as written, because the one rule is that we keep every single detail and never invent options. 💀

• -m, --message <msg> — Commit the changes in the dist-git repository and use <msg> as the commit message.

Mutually exclusive with -F. So pick a lane, bestie, you can't have both. 🫶

• -F, --file <file> — Commit the changes in the dist-git repository and take the commit message from <file>. Use - to read from the standard input. Piping supremacy honestly. 🍓
• -f, --force — Don't check the synchronization status of the source-git and dist-git repos prior to performing the update. Big "I know what I'm doing" energy — use it on purpose, not by accident. 🔥

---

and that's the whole page, babe 🎀

this is version 1.16.3, dated 2026-09-04, and it lives in the PACKIT...IST-GIT(1) manual — go forth and update those dist-git repos responsibly, mwah 💅✨