.Dd January 26, 2020
.Dt NOTEMAP 1
.Os
.
.Sh NAME
.Nm notemap
.Nd mirror notes to IMAP
.
.Sh SYNOPSIS
.Nm
.Op Fl afv
.Op Fl M Ar mailbox
.Op Fl h Ar host
.Op Fl m Ar file
.Op Fl p Ar port
.Op Fl u Ar user
.Op Ar
.
.Sh DESCRIPTION
The
.Nm
utility
mirrors text notes
to an IMAP mailbox.
Files are mapped to IMAP messages
using a map file.
If no files are given as arguments,
all mapped files are mirrored.
.
.Pp
The arguments are as follows:
.Bl -tag -width Ds
.It Fl M Ar mailbox
Mirror notes to
.Ar mailbox .
The default is
.Sy Notes .
.
.It Fl a
Add new notes to the map file.
.
.It Fl f
Overwrite notes which have changed in the mailbox.
.
.It Fl h Ar host
Connect to IMAP on
.Ar host .
The default host is determined
by SRV record lookup on the domain of
.Ar user ,
or simply the domain name
if no SRV record exists.
Lookup requires
.Xr dig 1 .
.
.It Fl m Ar file
Set the location of the map file.
The default is
.Pa .notemap .
.
.It Fl p Ar port
Connect to IMAP on
.Ar port .
If the
.Fl h
option is used,
the default port is
.Sy imaps
(993).
Otherwise,
the port is determined
in the same fashion as the host.
.
.It Fl u Ar user
Log in to IMAP as
.Ar user .
.
.It Fl v
Log IMAP protocol to standard error.
.El