aboutsummaryrefslogtreecommitdiff
path: root/README.md
blob: 146d9a2c346833b57a0e67ebb75b93c697d0c9ad (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
# Table of Contents

1.  [Introduction](#org96a3616)
2.  [Demo](#org65da1cb)
3.  [Installation](#orgc576a29)
4.  [Related packages](#orgc795f7e)
5.  [Contributing](#orgacd2afe)



<a id="org96a3616"></a>

# Introduction

`git-email` integrates git and email with Emacs, it offers two main
functions for sending email with git.

-   `git-email-send-email` will send the marked files as patches using your
    mail client of choice.  This means that you have to first run
    `git format-patch` to generate the patches.

-   `git-email-format-patch` will ask you for a revision and generate
    patches for all the changes that occured between the revision and the
    current HEAD.  It will then prepare the patches as email messages in
    the same way as `git-email-send-email`.

You can see all the customizable variables running M-x `customize-group`
RET `git-email` RET.

If you want to easily apply patches you have recieved, you should
checkout [piem](https://git.kyleam.com/piem).


<a id="org65da1cb"></a>

# Demo

![img](demo.gif)


<a id="orge581435"></a>

# Features

`git-email` offers minor modes for Gnus and Notmuch, these minor modes
will just configure some variables for you and provide any extra
functionality as of right now.

There is also integration with magit in the `git-email-magit.el`
library.  This will faciliate the transient library, you can send a
patch from the magit status buffer by pressing `W c s`.


<a id="org2f12f6d"></a>

# Installation

You can install it by cloning this repo and adding `git-email.el` to your `load-path`.


<a id="orgc795f7e"></a>

# Related packages

-   [piem](https://git.kyleam.com/piem/) - gluing together public-inbox archives and git


<a id="orgacd2afe"></a>

# Contributing

You can send patches and bug reports to the [git-email-devel](https://lists.sr.ht/~yoctocell/git-email-devel) mailing list.

**Note:** The README.md is generated from README.org