mbox-extract-patch(1)

📦
version 31 · 3 versions
, in debian trixie, ubuntu questing, ubuntu resolute, ubuntu stonking

💖 mbox-extract-patch — the manual, but make it cute 💖

okay so bestie, welcome to mbox-extract-patch(1), a User Commands girly from the Debian Project, and she is so good at what she does. let's get into it 🫶

✨ NAME ✨

mbox-extract-patch — extract a git patch series from an mbox 💅

🌸 SYNOPSIS 🌸

mbox-extract-patch [OPTIONS] <MBOX

like, that's it. that's the whole vibe. she reads from stdin, no cap. 🦋

🎀 DESCRIPTION 🎀

so mbox-extract-patch extracts a whole series of git patches out of an mbox, and honestly? iconic behaviour. she's built specifically to pull patches that were originally sent with git-send-email(1) — that's her whole thing, that's her moment.

and the best part: she skips cover letters and skips replies/reviews in her output. no messy extras, just the patches. she's giving curated. ✨

💅 OPTIONS 💅

  • -v|--reroll-count=N — try to pull out the *N*th version of a patch series, where those patches are identified by subject prefixes like "[PATCH vN 1/3]". 👑

if you don't pass this option, and there's more than one series hanging around, she defaults to extracting the version of the patch series with the highest version number she can find. main character decision-making fr fr.

ngl, you should not usually need this option, because best practices when sharing patches with git-send-email(1) include starting a new thread when posting a revised series. the --in-reply-to option to git-format-patch(1) is used mainly for posting a patch series in reply to a bug report. so like… iykyk.
  • --trailers — extract and add to patches lines like
Acked-by: A. Developer <a.dev@example.net>

that were sent in reply to those patches. --trailers is on by default, and --no-trailers can be used to disable adding the trailers. she's helpful like that 💖

  • --cover-letter-trailers — additionally add to all patches in the series any trailers sent in reply to the cover letter of the patch series. yes, all of them. she said "and you're getting the cover letter ones too" 🎀

🌈 EXAMPLE 🌈

% git checkout -b test-feature
% mbox-extract-patch <thread.mbox | git am

look at her go. flawless. ⭐

💀 LIMITATIONS 💀

detection of cover letters is currently quite simplistic. she's doing her best okay 😭 it's giving "working on it".

👑 SEE ALSO 👑

notmuch(1), git-send-email(1), notmuch-extract-patch(1)

the whole squad fr. go say hi. 🦋

💜 AUTHOR 💜

Sean Whitton <spwhitton@spwhitton.name> — thank you for your service, legend 🫶

and that's the page babes!! brought to you by perl v5.40.1 and the Debian Project 💖 mwah, go extract some patches, you're gonna slay ✨🌸

📦 where this page comes from