NAME

git-fetch-email — fetch patches over IMAP

SYNOPSIS

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

DESCRIPTION

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:

-C cc | --cc=cc | --no-cc: Fetch patches with matching Cc headers. The default is the value of fetchemail.cc.
-F from | --from=from | --no-from: Fetch patches with matching From headers. The default is the value of fetchemail.from.
-H | --headers: Fetch only patch headers.
-M mailbox | --move-to=mailbox | --no-move-to: Move matching patches to mailbox. With --apply, only move patches if git-am(1) is successful. The default is the value of fetchemail.moveTo.
-S subject | --subject=subject | --no-subject: Fetch patches with matching Subject headers. The default is the value of fetchemail.subject, or ‘[PATCH’.
-T to | --to=to | --no-to: Fetch patches with matching To headers. The default is the value of fetchemail.to.
-U | --unseen | --no-unseen: Fetch only patches which are unseen. The default is the value of fetchemail.unseen.
-a | --apply: 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.
-h host | --host=host: Connect to IMAP on host. The default is the value of fetchemail.imapServer, or as inferred by imbox(1).
-i | --idle: Wait for matching patches using IMAP IDLE.
-m mailbox | --mailbox=mailbox: Fetch patches from mailbox. The default is the value of fetchemail.imapMailbox, or INBOX.
-p port | --port=port: Connect to IMAP on port. The default is the value of fetchemail.imapServerPort, or as inferred by imbox(1).
-s | --mark-seen | --no-mark-seen: Mark matching patches as seen. With --apply, only mark patches if git-am(1) is successful. The default is the value of fetchemail.markSeen.
-u user | --user=user: Log in to IMAP as user. The default is the value of fetchemail.imapUser.
-v | --verbose: 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).

EXAMPLES

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

AUTHORS

June McEnroe <june@causal.agency>

BUGS

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

June 5, 2021

OpenBSD 7.8