maildir-import-patch(1)

πŸ“¦
version 31 Β· 3 versions
, in debian trixie, ubuntu questing, ubuntu resolute, ubuntu stonking

✨ maildir-import-patch(1) ✨

okay bestie, welcome to maildir-import-patch, a User Command, and no this is not a drill, it's literally the glow-up your code review game has been waiting for πŸ’…


🌸 NAME 🌸

maildir-import-patch β€” import a git patch series into a maildir πŸ¦‹


✨ SYNOPSIS ✨

maildir-import-patch MAILDIR [git-format-patch(1) args]

πŸ’– DESCRIPTION πŸ’–

So here's the tea, bestie: maildir-import-patch generates a patch series using git-format-patch(1), and then imports that series into a maildir as an e-mail thread β€” one message per patch, periodt. πŸŽ€

It's giving extremely useful when you wanna provide inline feedback on a branch by e-mail and the submitter did not use git-send-email(1). Like, they skipped the whole email pipeline and now it's your problem? No worries, this tool has you covered. 🫢


🌈 EXAMPLE 🌈

Picture this: Bob uses git-request-pull(1) to ask you to review and merge his branch 'feature'. Iconic of him. So you:

  • add Bob's repository as a remote called 'bob' ✨
  • check out the bob/feature branch locally πŸ’…
  • look at the commits and run some tests πŸ”₯

And now you're lowkey obsessed with giving inline feedback on Bob's changes β€” pointing out which parts are ready to merge and which parts need more work. So you type:

% maildir-import-patch ~/Maildir/patches master..bob/feature

Then over in your MUA, you can reply to each e-mail in the new thread that maildir-import-patch just generated, providing line-by-line feedback on Bob's work. Main character energy, honestly. πŸ‘‘


πŸ’œ GIT CONFIGURATION KEYS πŸ’œ

  • mailscripts.project-shortname β€” a short identifier for the project, and it gets prepended to the subject lines of generated patches, like this: "[PATCH shortname imported]". If it's unset, it defaults to the name of the root directory of the repository. πŸ“

Heads up though: this key is ignored if any --subject-prefix option is present in the arguments that are gonna be passed on to git-format-patch(1). iykyk πŸ™ˆ


πŸ‘€ SEE ALSO πŸ‘€

notmuch-import-patch(1), git-format-patch(1), git-send-email(1)

go read those too bestie, they're the supporting cast πŸ’–


πŸŽ€ AUTHOR πŸŽ€

notmuch-import-patch was written by Sean Whitton <spwhitton@spwhitton.name>. πŸ’œ

(yes bestie, the page says notmuch-import-patch right there in the AUTHOR section β€” i am simply reporting the facts, i don't make the rules 🌸)


and that's a wrap, angel πŸ’« this was perl v5.40.1, brought to you by the Debian Project, and it's your girl maildir-import-patch(1) signing off β€” go forth and review those patches, you absolute icon πŸ¦‹βœ¨πŸ’…
πŸ“¦ where this page comes from