README.7


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

.Dd January 28, 2020
.Dt README 7
.Os "Causal Agency"
.
.Sh NAME
.Nm notemap
.Nd mirror notes to IMAP
.
.Sh DESCRIPTION
.Xr notemap 1
mirrors text files to an IMAP mailbox
in a format compatible with the iOS Notes app.
It's intended to make notes managed in
.Xr git 1
easily accessible from the phone.
.
.Pp
.Nm
requires LibreSSL
.Pq Fl ltls
and either
.Xr dig 1
or
.Xr drill 1
for automatic IMAP server configuration.
.
.Pp
Build configuration can be written to
.Pa config.mk .
The install prefix of LibreSSL is set by
.Va LIBRESSL_PREFIX .
The path of
.Xr dig 1
or
.Xr drill 1
can be set by defining the C preprocessor macro
.Va DIG_PATH
or
.Va DRILL_PATH ,
respectively.
The default is to set
.Va DRILL_PATH
to
.Pa /usr/bin/drill
on
.Fx
and set
.Va DIG_PATH
to
.Pa dig
everywhere else.
.
.Sh CONTRIBUTING
The upstream URL of this project is
.Aq Lk https://git.causal.agency/notemap .
I'm happy to receive contributions in any form at
.Aq Mt june@causal.agency .
For sending patches by email, see
.Aq Lk https://git-send-email.io .
.
.Sh SEE ALSO
.Xr notemap 1