about summary refs log tree commit diff
path: root/git-fetch-email.1
blob: 2ee3a6f191b4ac9d56bc6369637db5a3cc0e814f (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
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
.Dd December 21, 2019
.Dt GIT-FETCH-EMAIL 1
.Os
.
.Sh NAME
.Nm git-fetch-email
.Nd fetch patches over IMAP
.
.Sh SYNOPSIS
.Nm git
.Cm fetch-email
.Op Fl C Ar cc
.Op Fl F Ar from
.Op Fl S Ar subject
.Op Fl T Ar to
.Op Fl h Ar host
.Op Fl m Ar mailbox
.Op Fl p Ar port
.Op Ar user
.
.Sh DESCRIPTION
The
.Nm
command is a wrapper around
.Xr imbox 1
using
.Xr git-config 1
and
.Xr git-credential 1 .
It fetches patches to be piped into
.Xr git-am 1 .
.
.Pp
The arguments are as follows:
.Bl -tag -width Ds
.It Fl C Ar cc
Fetch patches with matching
.Cm Cc
headers.
The default is the value of
.Cm fetchemail.cc .
.
.It Fl F Ar from
Fetch patches with matching
.Cm From
headers.
The default is the value of
.Cm fetchemail.from .
.
.It Fl S Ar subject
Fetch patches with matching
.Cm Subject
headers.
The default is the value of
.Cm fetchemail.subject ,
or
.Ql [PATCH .
.
.It Fl T Ar to
Fetch patches with matching
.Cm To
headers.
The default is the value of
.Cm fetchemail.to .
.
.It Fl h Ar host
Connect to IMAP on
.Ar host .
The default is the value of
.Cm fetchemail.imapServer ,
or as inferred by
.Xr imbox 1 .
.
.It Fl m Ar mailbox
Fetch patches from
.Ar mailbox .
The default is the value of
.Cm fetchemail.imapMailbox ,
or INBOX.
.
.It Fl p Ar port
Connect to IMAP on
.Ar port .
The default is the value of
.Cm fetchemail.imapServerPort ,
or as inferred by
.Xr imbox 1 .
.El
.
.Pp
If
.Ar user
is not provided,
the value of
.Cm fetchemail.imapUser
is used.
If
.Cm fetchemail.imapPass
is set,
it is used as the IMAP login password,
otherwise the password is obtained using
.Xr git-credential 1 .
.
.Sh EXAMPLES
.Bd -literal
git config fetchemail.to list@example.org
git fetch-email june@causal.agency | git am
.Ed
.
.Sh SEE ALSO
.Xr git-am 1 ,
.Xr imbox 1 ,
.Xr gitcredentials 7
.
.Sh AUTHORS
.An June Bug Aq Mt june@causal.agency
.
.Sh BUGS
Send mail to
.Aq Mt june@causal.agency
or join
.Li #ascii.town
on
.Li chat.freenode.net .