DPATCH(7)

📦 version 2.0.41, in ubuntu jammy

💖 DPATCH(7) — the dpatch manual, bestie edition 💖

okay so you're looking at a page from the dpatch manual (section 7, we're fancy like that) and honestly? it's giving legacy. but let's go, because you deserve to know.

✨ NAME ✨

debian/patches/script.dpatch — a patch that applies itself, no cap 🫶

🌸 SYNOPSIS 🌸

debian/patches/script.dpatch -patch [directory]
debian/patches/script.dpatch -unpatch [directory]
debian/patches/script.dpatch -pkg-custom [directory]

🦋 DESCRIPTION 🦋

so a dpatch is literally just a program that modifies the source tree inside a given directory. how it does that? entirely up to whoever wrote it, bestie. total creative freedom, main character energy. it can be a lil script that calls patch(1) with the right options, or a whole complicated perl script doing deep arcane magic, or honestly anything else your heart desires. 🌈

the only requirement — and she is strict about this one — is that it MUST accept the -patch and -unpatch options, followed by the destination (aka working) directory, when one is specified. note the "when specified" because for compatibility reasons, that second argument is only present when a working directory was explicitly set with dpatch --workdir. iykyk. 💅

and for some of the dpatch(1) features to actually work, your script should follow a common style. there should be a line near the top of the file that looks exactly like this:

filename -- author <email>

and one or more lines that look like this:

# DP: description

these get used by things like dpatch cat, for example. so like, do it. it's not optional-optional but it's the vibe. 🎀

⚠️ WARNING ⚠️

dpatch is deprecated, bestie. please switch to the 3.0 (quilt) Debian source package format instead. 😭

there's a short guide on how to do that over at http://wiki.debian.org/Projects/DebSrc3.0#FAQ — go read it, i'm begging.

🌟 EXAMPLES 🌟

you can find dpatch examples chilling under /usr/share/doc/dpatch/examples/. go look, they're right there. 👑

💜 AUTHOR 💜

this manual page was written by Gergely Nagy. thank you for your service. 🫶

👀 SEE ALSO 👀

and that's the whole page, babe ✨ this was DPATCH 2, dated Dec 13 2011 — oldie but a goodie, slay, periodt. 💅🌸

📦 where this page comes from