.Dd February 24, 2021
.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 Uaisv
.Op Fl C Ar cc
.Op Fl F Ar from
.Op Fl M Ar mailbox
.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 Fl u Ar user
.Oo
.Fl Fl
.Ar args ...
.Oc
.
.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 applied with
.Xr git-am 1 .
.
.Pp
The arguments are as follows:
.Bl -tag -width Ds
.It Fl C Ar cc , Fl \-cc Ns = Ns Ar cc , Fl \-no\-cc
Fetch patches with matching
.Cm Cc
headers.
The default is the value of
.Cm fetchemail.cc .
.
.It Fl F Ar from , Fl \-from Ns = Ns Ar from , Fl \-no\-from
Fetch patches with matching
.Cm From
headers.
The default is the value of
.Cm fetchemail.from .
.
.It Fl M Ar mailbox , Fl \-move\-to Ns = Ns Ar mailbox , Fl \-no\-move\-to
Move matching patches to
.Ar mailbox .
With
.Fl \-apply ,
only move patches if
.Xr git-am 1
is successful.
The default is the value of
.Cm fetchemail.moveTo .
.
.It Fl S Ar subject, Fl \-subject Ns = Ns Ar subject , Fl \-no\-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 , Fl \-to Ns = Ns Ar to , Fl \-no\-to
Fetch patches with matching
.Cm To
headers.
The default is the value of
.Cm fetchemail.to .
.
.It Fl U , Fl \-unseen , Fl \-no-unseen
Fetch only patches which are unseen.
The default is the value of
.Cm fetchemail.unseen .
.
.It Fl a , Fl \-apply
Apply patches with
.Xr git-am 1 .
The arguments
.Fl \-patch\-format Ns = Ns mboxrd
are passed to
.Xr git-am 1
along with any arguments following
.Ql Fl \-
passed to
.Nm .
.
.It Fl h Ar host , Fl \-host Ns = Ns 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 i , Fl \-idle
Wait for matching patches
using IMAP IDLE.
.
.It Fl m Ar mailbox , Fl \-mailbox Ns = Ns Ar mailbox
Fetch patches from
.Ar mailbox .
The default is the value of
.Cm fetchemail.imapMailbox ,
or INBOX.
.
.It Fl p Ar port , Fl \-port Ns = Ns Ar port
Connect to IMAP on
.Ar port .
The default is the value of
.Cm fetchemail.imapServerPort ,
or as inferred by
.Xr imbox 1 .
.
.It Fl s , Fl \-mark\-seen , Fl \-no\-mark\-seen
Mark matching patches as seen.
With
.Fl \-apply ,
only mark patches if
.Xr git-am 1
is successful.
The default is the value of
.Cm fetchemail.markSeen .
.
.It Fl u Ar user , Fl \-user Ns = Ns Ar user
Log in to IMAP as
.Ar user .
The default is the value of
.Cm fetchemail.imapUser .
.
.It Fl v , Fl \-verbose
Log IMAP protocol to standard error.
.El
.
.Pp
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.imapUser june@causal.agency
git config fetchemail.to list+imbox@causal.agency
git fetch-email --apply
.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 list+imbox@causal.agency
or join
.Li #ascii.town
on
.Li chat.freenode.net .