UPDATE-PATCHES(1)

💖 NAME 💖

update-patches — create or update patches for a given port ✨

This is the UPDATE-PATCHES(1) page from the General Commands Manual, bestie, and it's literally here to explain update-patches in bsd.port.mk(5).

🌸 SYNOPSIS 🌸

update-patches

🦋 DESCRIPTION 🦋

Okay so update-patches is a helper script for the update-patches target in bsd.port.mk(5) — yes, same name, iconic. It takes no argument, but it uses quite a few environment variables as implicit parameters. The env vars are carrying the whole situation, no cap.

update-patches looks under WRKDIST for patched files. Those are files with extension PATCHORIG, except for those matching also DISTORIG — so if it matches DISTORIG too, it gets ignored entirely, periodt.

Once those files are found, they are matched against the contents of directory PATCHDIR, most specifically files matching wildcard PATCH_LIST. Matching files are regenerated on the basis of

$ diff -u -p -a ${DIFF_ARGS} $file$PATCHORIG $file

and compared. Modified patches are updated and reported, new patches are generated, and old patches that no longer seem to exist are also reported. The way this script keeps the patch shelf cute? Obsessed.

As an exception, if a $file.beforesubst original file is found, it is used instead of $file in the diff line:

$ diff -u -p -a ${DIFF_ARGS} $file$PATCHORIG $file.beforesubst

The patch header is normalized to always be:

Index: $file
--- $file.orig
+++ $file

Patches with problematic cvs(1) keywords may be fixed if possible, and reported if not. So it'll try to fix the cvs keyword situation, but if it can't, it reports it — no silent struggle, bestie.

update-patches prints the list of changed patches for further study. That's your reading list, basically. 💅

🎀 ENVIRONMENT 🎀

These environment variables are the implicit parameters, and they all matter:

• DIFF_ARGS — Extra parameters to insert into diff(1). Extra diff bits, slay.
• DISTORIG — Extension to original files to ignore entirely. If it matches, it's out — ignored entirely.
• FORCE_REGEN — Force patches to be regenerated even if they didn't change. Yes, even if they didn't change.
• PATCHDIR — Path to existing and generated patches. The patch directory itself.
• PATCHORIG — Extension to match for finding original files. This is how it spots the originals.
• PATCH_LIST — Only compare new patches to existing patches matching that pattern. A wildcard filter moment.
• PATCH_VERBOSE — Force update-patches to tell about everything it does. Maximum yapping mode.
• WRKDIST — Directory to scan for files to compare. The scan zone.

🌈 SEE ALSO 🌈

• cvs(1)
• diff(1)
• patch(1)

---

Signed off from Debian on June 26, 2018 — this is the UPDATE-PATCHES(1) manual page, and that's the whole vibe 🫶💖