summary refs log tree commit diff
path: root/notemap.1
blob: 43467d5ae6ac423610edb68e6464549cec7b3066 (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
.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