about summary refs log tree commit diff
GIT-FETCH-EMAIL(1) General Commands Manual GIT-FETCH-EMAIL(1)

git-fetch-emailfetch patches over IMAP

git fetch-email [-HUaisv] [-C cc] [-F from] [-M mailbox] [-S subject] [-T to] [-h host] [-m mailbox] [-p port] [-u user] [-- args ...]

The git-fetch-email command is a wrapper around imbox(1) using git-config(1) and git-credential(1). It fetches patches to be applied with git-am(1).

The arguments are as follows:

cc | =cc |
Fetch patches with matching Cc headers. The default is the value of fetchemail.cc.
from | =from |
Fetch patches with matching From headers. The default is the value of fetchemail.from.
|
Fetch only patch headers.
mailbox | =mailbox |
Move matching patches to mailbox. With --apply, only move patches if git-am(1) is successful. The default is the value of fetchemail.moveTo.
subject | =subject |
Fetch patches with matching Subject headers. The default is the value of fetchemail.subject, or ‘[PATCH’.
to | =to |
Fetch patches with matching To headers. The default is the value of fetchemail.to.
| |
Fetch only patches which are unseen. The default is the value of fetchemail.unseen.
|
Apply patches with git-am(1). The arguments --patch-format=mboxrd are passed to git-am(1) along with any arguments following ‘--’ passed to git-fetch-email.
host | =host
Connect to IMAP on host. The default is the value of fetchemail.imapServer, or as inferred by imbox(1).
|
Wait for matching patches using IMAP IDLE.
mailbox | =mailbox
Fetch patches from mailbox. The default is the value of fetchemail.imapMailbox, or INBOX.
port | =port
Connect to IMAP on port. The default is the value of fetchemail.imapServerPort, or as inferred by imbox(1).
| |
Mark matching patches as seen. With --apply, only mark patches if git-am(1) is successful. The default is the value of fetchemail.markSeen.
user | =user
Log in to IMAP as user. The default is the value of fetchemail.imapUser.
|
Log IMAP protocol to standard error.

If fetchemail.imapPass is set, it is used as the IMAP login password, otherwise the password is obtained using git-credential(1).

git config fetchemail.imapUser june@causal.agency
git config fetchemail.to list+imbox@causal.agency
git fetch-email --apply

git-am(1), imbox(1), gitcredentials(7)

June McEnroe <june@causal.agency>

Send mail to <list+imbox@causal.agency> or join #ascii.town on irc.tilde.chat.

June 5, 2021 OpenBSD 7.4