5 Integration with other packages

‘git-email’ offers minor modes for Gnus, Mu4e, Notmuch, and Piem. These minor modes provide support for these other packages by modifying some variables such as git-email-compose-email-function, git-email-get-to-address-functions etc.

For users of gnus-alias, See git-email-post-compose-email-functions.

There is also integration with Magit in the git-email-magit.el library. This uses the transient library and allows one to send a patch from the magit status buffer by pressing W c s. The prefix argument (if any) is passed on to git-email-send-email.

In order to enable Magit integration, ensure that the below or equivalent is evaluated:

(with-eval-after-load 'magit
  (git-email-magit-setup))

• git-email-magit-setup is an autoloaded function and is the preferred way to enable git-email’s Magit integration. It:
  • - Adds the git-email-magit-patch-send (W c s) suffix to the magit-patch-create transient.
  • - Adds git-email-magit-sendemail-to (b E) and git-email-magit-branch-sendemail-to (b e) suffixes to the magit-branch transient.
  • - Allows for customization of the subject prefix via the git-email-magit-subject-prefix variable.
  • - Sets the thread style for patches to correspond to the git-email-magit-format-patch-thread setting.
  • - Makes the “Mail arguments” group visible in the magit-patch-create transient menu.
• git-email-magit-sendemail-to is bound to b E in the magit-branch transient-suffix. The integration provides a way to view or set a repository-specific sendemail.to value.
• git-email-magit-branch-sendemail-to is bound to b e in the magit-branch transient-suffix. The integration provides a way to view or set a branch-specific sendemail-to value.
• git-email-magit-format-patch-thread is a buffer-local variable that controls the thread style default that’s used when creating patches. The default used by git-format-patch is intended for use with git-send-email and delegates the responsibility for creation of headers, such as “Message-ID”, to the latter. However, this is unsuitable for users of git-email since they bypass git-send-email. The initial value of git-email-magit-format-patch-thread is ‘shallow’ and matches the default used by git-send-email.
• git-email-magit-subject-prefix is a buffer-local variable which controls the default subject prefix used by magit-patch-create and git-email-magit-patch-send. If you wish to set the subject-prefix to be used when creating patches in a directory-specific manner, you can do so by setting git-email-magit-subject-prefix in your project’s ‘.dir-locals.el’ file.