aboutsummaryrefslogtreecommitdiff
path: root/README.md
blob: 7531f7decb567d2883bc611dd187305dabc3cd1c (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
# Table of Contents

1.  [Introduction](#org1c3770f)
2.  [Demo](#org22efe78)
3.  [Installation](#org2f11d3b)
4.  [Related packages](#org518440b)
5.  [Contributing](#org16a78b5)



<a id="org1c3770f"></a>

# Introduction

`git-email` integrates git and email with Emacs, it offers three main
functions for sending and receiving 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`.

-   `git-email-apply-patch` will ask you for a project to cd into and then
    apply the patch in the current buffer using `git am`.  You can also
    specify your own function to extract the patch from the buffer by
    changing the `git-email-apply-patch-function` variable.

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


<a id="org22efe78"></a>

# Demo

![img](demo.gif)


<a id="org2f11d3b"></a>

# Installation

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


<a id="org518440b"></a>

# Related packages

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


<a id="org16a78b5"></a>

# Contributing

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

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