sup 1.2 → 1.3
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- checksums.yaml +4 -4
- data/.github/workflows/checks.yml +16 -2
- data/.gitmodules +1 -0
- data/History.txt +16 -0
- data/Manifest.txt +12 -1
- data/contrib/nix/Gemfile +2 -0
- data/contrib/nix/Gemfile.lock +37 -16
- data/contrib/nix/gem-install-shell.nix +2 -0
- data/contrib/nix/gemset.nix +83 -31
- data/contrib/nix/ruby2.4-Gemfile.lock +5 -1
- data/contrib/nix/ruby2.4-gemset.nix +22 -2
- data/contrib/nix/ruby2.4-shell.nix +2 -6
- data/contrib/nix/ruby2.5-Gemfile.lock +5 -1
- data/contrib/nix/ruby2.5-gemset.nix +22 -2
- data/contrib/nix/ruby2.5-shell.nix +2 -6
- data/contrib/nix/ruby2.6-Gemfile.lock +5 -1
- data/contrib/nix/ruby2.6-gemset.nix +22 -2
- data/contrib/nix/ruby2.6-shell.nix +2 -6
- data/contrib/nix/ruby2.7-Gemfile.lock +91 -0
- data/contrib/nix/ruby2.7-gemset.nix +359 -0
- data/contrib/nix/ruby2.7-shell.nix +2 -11
- data/contrib/nix/ruby3.0-Gemfile.lock +91 -0
- data/contrib/nix/ruby3.0-gemset.nix +359 -0
- data/contrib/nix/ruby3.0-shell.nix +2 -11
- data/contrib/nix/ruby3.1-shell.nix +9 -7
- data/contrib/nix/ruby3.2-shell.nix +9 -7
- data/contrib/nix/ruby3.3-shell.nix +9 -7
- data/contrib/nix/ruby3.4-shell.nix +36 -0
- data/contrib/nix/test-all-rubies.sh +1 -1
- data/lib/sup/crypto.rb +7 -5
- data/lib/sup/maildir.rb +4 -0
- data/lib/sup/mbox.rb +25 -7
- data/lib/sup/message.rb +13 -10
- data/lib/sup/modes/edit_message_mode.rb +5 -5
- data/lib/sup/util.rb +9 -2
- data/lib/sup/version.rb +1 -1
- data/man/sup-add.1 +15 -15
- data/man/sup-config.1 +9 -9
- data/man/sup-dump.1 +13 -12
- data/man/sup-import-dump.1 +20 -20
- data/man/sup-psych-ify-config-files.1 +11 -11
- data/man/sup-recover-sources.1 +18 -18
- data/man/sup-sync-back-maildir.1 +18 -17
- data/man/sup-sync.1 +29 -29
- data/man/sup-tweak-labels.1 +22 -21
- data/man/sup.1 +21 -21
- data/sup.gemspec +2 -0
- data/test/dummy_source.rb +6 -0
- data/test/fixtures/embedded-message-rfc6532.eml +33 -0
- data/test/fixtures/invalid-date.eml +8 -0
- data/test/gnupg_test_home/private-keys-v1.d/26C05E44706A8E230B3255BB9532B34DC9420232.key +42 -0
- data/test/gnupg_test_home/private-keys-v1.d/D187ADC90EC4DEB7047678EAA37E33A53A465D47.key +5 -0
- data/test/gnupg_test_home/private-keys-v1.d/FB2D9BD3B1BE90B5BCF697781F8404224B0FCF5B.key +5 -0
- data/test/gnupg_test_home/pubring.gpg +0 -0
- data/test/gnupg_test_home/receiver_pubring.gpg +0 -0
- data/test/gnupg_test_home/receiver_secring.gpg +0 -0
- data/test/gnupg_test_home/regen_keys.sh +11 -2
- data/test/gnupg_test_home/secring.gpg +0 -0
- data/test/gnupg_test_home/sup-test-2@foo.bar.asc +20 -20
- data/test/integration/test_maildir.rb +15 -1
- data/test/integration/test_mbox.rb +10 -0
- data/test/test_crypto.rb +108 -71
- data/test/test_message.rb +42 -0
- data/test/unit/test_contact.rb +1 -1
- data/test/unit/test_edit_message_mode.rb +94 -0
- data/test/unit/test_person.rb +3 -3
- data/test/unit/test_rmail_message.rb +36 -0
- data/test/unit/util/test_string.rb +3 -3
- metadata +50 -5
- data/test/gnupg_test_home/private-keys-v1.d/306D2EE90FF0014B5B9FD07E265C751791674140.key +0 -0
@@ -563,7 +563,7 @@ protected
|
|
563
563
|
## there are attachments, so wrap body in an attachment of its own
|
564
564
|
unless @attachments.empty?
|
565
565
|
body_m = m
|
566
|
-
body_m.header["Content-Disposition"] = "inline"
|
566
|
+
body_m.header["Content-Disposition"] = +"inline"
|
567
567
|
m = RMail::Message.new
|
568
568
|
|
569
569
|
m.add_part body_m
|
@@ -601,8 +601,8 @@ protected
|
|
601
601
|
m.header["Date"] = date.rfc2822
|
602
602
|
m.header["Message-Id"] = @message_id
|
603
603
|
m.header["User-Agent"] = "Sup/#{Redwood::VERSION}"
|
604
|
-
m.header["Content-Transfer-Encoding"] ||=
|
605
|
-
m.header["MIME-Version"] = "1.0" if m.multipart?
|
604
|
+
m.header["Content-Transfer-Encoding"] ||= +"8bit"
|
605
|
+
m.header["MIME-Version"] = +"1.0" if m.multipart?
|
606
606
|
m
|
607
607
|
end
|
608
608
|
|
@@ -716,10 +716,10 @@ private
|
|
716
716
|
## encode to quoted-printable for all text/* MIME types,
|
717
717
|
## use base64 otherwise
|
718
718
|
if msg_part.header["Content-Type"] =~ /text\/.*/
|
719
|
-
msg_part.header
|
719
|
+
msg_part.header.set "Content-Transfer-Encoding", +"quoted-printable"
|
720
720
|
msg_part.body = [msg_part.body].pack('M')
|
721
721
|
else
|
722
|
-
msg_part.header
|
722
|
+
msg_part.header.set "Content-Transfer-Encoding", +"base64"
|
723
723
|
msg_part.body = [msg_part.body].pack('m')
|
724
724
|
end
|
725
725
|
msg_part
|
data/lib/sup/util.rb
CHANGED
@@ -80,7 +80,14 @@ module RMail
|
|
80
80
|
def self.make_file_attachment fn
|
81
81
|
bfn = File.basename fn
|
82
82
|
t = MIME::Types.type_for(bfn).first || MIME::Types.type_for("exe").first
|
83
|
-
|
83
|
+
payload = IO.read fn
|
84
|
+
## Need to encode as base64 or quoted-printable if any lines are longer than 998 chars.
|
85
|
+
encoding = if t.encoding != t.default_encoding and payload.each_line.any? { |l| l.length > 998 }
|
86
|
+
t.default_encoding
|
87
|
+
else
|
88
|
+
t.encoding
|
89
|
+
end
|
90
|
+
make_attachment payload, t.content_type, encoding, bfn.to_s
|
84
91
|
end
|
85
92
|
|
86
93
|
def charset
|
@@ -206,7 +213,7 @@ class String
|
|
206
213
|
end
|
207
214
|
|
208
215
|
def slice_by_display_length len
|
209
|
-
each_char.each_with_object "" do |c, buffer|
|
216
|
+
each_char.each_with_object (+"") do |c, buffer|
|
210
217
|
len -= Unicode::DisplayWidth.of(c)
|
211
218
|
return buffer if len < 0
|
212
219
|
buffer << c
|
data/lib/sup/version.rb
CHANGED
data/man/sup-add.1
CHANGED
@@ -1,10 +1,10 @@
|
|
1
|
-
.\" Automatically generated by Pandoc 3.1.
|
1
|
+
.\" Automatically generated by Pandoc 3.1.11.1
|
2
2
|
.\"
|
3
|
-
.TH "SUP
|
3
|
+
.TH "SUP\-ADD" "1" "April 9, 2012" "Sup User Manual" ""
|
4
4
|
.SH NAME
|
5
|
-
sup
|
5
|
+
sup\-add \- add a source to the Sup source list
|
6
6
|
.SH SYNOPSIS
|
7
|
-
sup
|
7
|
+
sup\-add [\f[I]options\f[R]] [\f[I]source uri\&...\f[R]]
|
8
8
|
.SH DESCRIPTION
|
9
9
|
Add one ore more sources to the Sup source list
|
10
10
|
.PP
|
@@ -25,33 +25,33 @@ maildir://<path to Maildir directory>
|
|
25
25
|
.EE
|
26
26
|
.SH OPTIONS
|
27
27
|
.TP
|
28
|
-
|
28
|
+
\-a, \-\-archive
|
29
29
|
Automatically archive all new messages from thesesources.
|
30
30
|
.TP
|
31
|
-
|
31
|
+
\-u, \-\-unusual
|
32
32
|
Do not automatically poll these sources for new messages.
|
33
33
|
.TP
|
34
|
-
|
35
|
-
A comma
|
34
|
+
\-l \f[I]STRING\f[R], \-\-labels \f[I]STRING\f[R]
|
35
|
+
A comma\-separated set of labels to apply to all messages from this
|
36
36
|
source
|
37
37
|
.TP
|
38
|
-
|
38
|
+
\-f, \-\-force\-new
|
39
39
|
Create a new account for this source, even if one already exists
|
40
40
|
.TP
|
41
|
-
|
41
|
+
\-o \f[I]STRING\f[R], \-\-force\-account \f[I]STRING\f[R]
|
42
42
|
Reuse previously defined account user\[at]hostname
|
43
43
|
.TP
|
44
|
-
|
44
|
+
\-v, \-\-version
|
45
45
|
Print version and exit
|
46
46
|
.TP
|
47
|
-
|
47
|
+
\-h, \-\-help
|
48
48
|
Show help message
|
49
49
|
.SH FILES
|
50
50
|
.TP
|
51
51
|
$HOME/.sup/sources.yaml
|
52
52
|
Configuration file for Sup mail sources
|
53
53
|
.SH SEE ALSO
|
54
|
-
sup(1), sup
|
54
|
+
sup(1), sup\-config(1)
|
55
55
|
.SH REPORTING BUGS
|
56
56
|
You are welcome to submit bug reports to the Sup issue tracker, located
|
57
57
|
at
|
@@ -87,11 +87,11 @@ Archives: \c
|
|
87
87
|
.UE \c
|
88
88
|
.RE
|
89
89
|
.SH COPYRIGHT
|
90
|
-
Copyright © 2006
|
90
|
+
Copyright © 2006\-2009 William Morgan \c
|
91
91
|
.MT mworgan-sup@masanjin.net
|
92
92
|
.ME \c
|
93
93
|
.PP
|
94
|
-
Copyright \[at] 2013
|
94
|
+
Copyright \[at] 2013\-2014 Sup developers
|
95
95
|
.PP
|
96
96
|
Permission is granted to copy and distribute this manual under the terms
|
97
97
|
of the GNU General Public License; either version 2 or (at your option)
|
data/man/sup-config.1
CHANGED
@@ -1,19 +1,19 @@
|
|
1
|
-
.\" Automatically generated by Pandoc 3.1.
|
1
|
+
.\" Automatically generated by Pandoc 3.1.11.1
|
2
2
|
.\"
|
3
|
-
.TH "SUP
|
3
|
+
.TH "SUP\-CONFIG" "1" "April 9, 2012" "Sup User Manual" ""
|
4
4
|
.SH NAME
|
5
|
-
sup
|
5
|
+
sup\-config \- interactive configuration tool for Sup
|
6
6
|
.SH SYNOPSIS
|
7
|
-
sup
|
7
|
+
sup\-config [\f[I]options\f[R]]
|
8
8
|
.SH DESCRIPTION
|
9
9
|
Interactive configuration tool for Sup.
|
10
10
|
Won\[cq]t destroy existing configuration.
|
11
11
|
.SH OPTIONS
|
12
12
|
.TP
|
13
|
-
|
13
|
+
\-v, \-\-version
|
14
14
|
Print versian and exit
|
15
15
|
.TP
|
16
|
-
|
16
|
+
\-h, \-\-help
|
17
17
|
Show help message
|
18
18
|
.SH FILES
|
19
19
|
.TP
|
@@ -23,7 +23,7 @@ Configuration file for Sup
|
|
23
23
|
$HOME/.sup/sources.yaml
|
24
24
|
Configuration file for Sup mail sources
|
25
25
|
.SH SEE ALSO
|
26
|
-
sup(1), sup
|
26
|
+
sup(1), sup\-add(1)
|
27
27
|
.SH REPORTING BUGS
|
28
28
|
You are welcome to submit bug reports to the Sup issue tracker, located
|
29
29
|
at
|
@@ -59,11 +59,11 @@ Archives: \c
|
|
59
59
|
.UE \c
|
60
60
|
.RE
|
61
61
|
.SH COPYRIGHT
|
62
|
-
Copyright © 2006
|
62
|
+
Copyright © 2006\-2009 William Morgan \c
|
63
63
|
.MT mworgan-sup@masanjin.net
|
64
64
|
.ME \c
|
65
65
|
.PP
|
66
|
-
Copyright \[at] 2013
|
66
|
+
Copyright \[at] 2013\-2014 Sup developers
|
67
67
|
.PP
|
68
68
|
Permission is granted to copy and distribute this manual under the terms
|
69
69
|
of the GNU General Public License; either version 2 or (at your option)
|
data/man/sup-dump.1
CHANGED
@@ -1,37 +1,38 @@
|
|
1
|
-
.\" Automatically generated by Pandoc 3.1.
|
1
|
+
.\" Automatically generated by Pandoc 3.1.11.1
|
2
2
|
.\"
|
3
|
-
.TH "SUP
|
3
|
+
.TH "SUP\-DUMP" "1" "April 9, 2012" "Sup User Manual" ""
|
4
4
|
.SH NAME
|
5
|
-
sup
|
5
|
+
sup\-dump \- dumps message state from Sup index
|
6
6
|
.SH SYNOPSIS
|
7
|
-
sup
|
7
|
+
sup\-dump [\f[I]options\f[R]]
|
8
8
|
.SH DESCRIPTION
|
9
9
|
Dumps all message state from the Sup index to standard out.
|
10
|
-
You can later use sup
|
10
|
+
You can later use sup\-sync \-\-restored \-\-restore to recover the
|
11
|
+
index.
|
11
12
|
.PP
|
12
13
|
This tool is primarily useful in the event that a Sup upgrade breaks
|
13
14
|
index format compatibility.
|
14
15
|
.SH OPTIONS
|
15
16
|
.TP
|
16
|
-
|
17
|
+
\-v, \-\-version
|
17
18
|
Print version and exit
|
18
19
|
.TP
|
19
|
-
|
20
|
+
\-h, \-\-help
|
20
21
|
Show help message
|
21
22
|
.SH EXAMPLES
|
22
23
|
Dump message state and store in file
|
23
24
|
.IP
|
24
25
|
.EX
|
25
|
-
sup
|
26
|
+
sup\-dump > filename
|
26
27
|
.EE
|
27
28
|
.PP
|
28
29
|
Dump message state and compress output to store in file
|
29
30
|
.IP
|
30
31
|
.EX
|
31
|
-
sup
|
32
|
+
sup\-dump | bzip2 > filename.bz2
|
32
33
|
.EE
|
33
34
|
.SH SEE ALSO
|
34
|
-
sup(1), sup
|
35
|
+
sup(1), sup\-sync(1), sup\-import\-dump(1)
|
35
36
|
.SH REPORTING BUGS
|
36
37
|
You are welcome to submit bug reports to the Sup issue tracker, located
|
37
38
|
at
|
@@ -67,11 +68,11 @@ Archives: \c
|
|
67
68
|
.UE \c
|
68
69
|
.RE
|
69
70
|
.SH COPYRIGHT
|
70
|
-
Copyright © 2006
|
71
|
+
Copyright © 2006\-2009 William Morgan \c
|
71
72
|
.MT mworgan-sup@masanjin.net
|
72
73
|
.ME \c
|
73
74
|
.PP
|
74
|
-
Copyright \[at] 2013
|
75
|
+
Copyright \[at] 2013\-2014 Sup developers
|
75
76
|
.PP
|
76
77
|
Permission is granted to copy and distribute this manual under the terms
|
77
78
|
of the GNU General Public License; either version 2 or (at your option)
|
data/man/sup-import-dump.1
CHANGED
@@ -1,45 +1,45 @@
|
|
1
|
-
.\" Automatically generated by Pandoc 3.1.
|
1
|
+
.\" Automatically generated by Pandoc 3.1.11.1
|
2
2
|
.\"
|
3
|
-
.TH "SUP
|
3
|
+
.TH "SUP\-IMPORT\-DUMP" "1" "April 9, 2012" "Sup User Manual" ""
|
4
4
|
.SH NAME
|
5
|
-
sup
|
5
|
+
sup\-import\-dump \- import message state dump to Sup index
|
6
6
|
.SH SYNOPSIS
|
7
|
-
sup
|
7
|
+
sup\-import\-dump [\f[I]options\f[R]] dumpfile
|
8
8
|
.SH DESCRIPTION
|
9
|
-
Imports message state previously exported by sup
|
10
|
-
sup
|
11
|
-
already been added using sup
|
12
|
-
If you need to recreate the index, see sup
|
9
|
+
Imports message state previously exported by sup\-dump into the index.
|
10
|
+
sup\-import\-dump operates on the index only, so the messages must have
|
11
|
+
already been added using sup\-sync.
|
12
|
+
If you need to recreate the index, see sup\-sync \-\-restore instead.
|
13
13
|
.PP
|
14
14
|
Messages not mentioned in the dump file will not be modified.
|
15
15
|
.SH OPTIONS
|
16
16
|
.TP
|
17
|
-
|
17
|
+
\-v, \-\-verbose
|
18
18
|
Print message ids as they\[cq]re processed
|
19
19
|
.TP
|
20
|
-
|
20
|
+
\-i, \-\-ignore\-missing
|
21
21
|
Silently skip over messages that are not in the index
|
22
22
|
.TP
|
23
|
-
|
23
|
+
\-w, \-\-warn\-missing
|
24
24
|
Warn about messages that are not in the index, but continue
|
25
25
|
.TP
|
26
|
-
|
26
|
+
\-a, \-\-abort\-missing
|
27
27
|
Abort on encountering messages that are not in the index (default)
|
28
28
|
.TP
|
29
|
-
|
29
|
+
\-t, \-\-atomic
|
30
30
|
Use transaction to apply all changes atomically
|
31
31
|
.TP
|
32
|
-
|
32
|
+
\-n, \-\-dry\-run
|
33
33
|
Don\[cq]t actually modify the index.
|
34
|
-
Probably only useful with
|
34
|
+
Probably only useful with \-\-verbose
|
35
35
|
.TP
|
36
|
-
|
36
|
+
\-\-version
|
37
37
|
Show version information
|
38
38
|
.TP
|
39
|
-
|
39
|
+
\-h, \-\-help
|
40
40
|
Show help message
|
41
41
|
.SH SEE ALSO
|
42
|
-
sup(1), sup
|
42
|
+
sup(1), sup\-sync(1), sup\-dump(1)
|
43
43
|
.SH REPORTING BUGS
|
44
44
|
You are welcome to submit bug reports to the Sup issue tracker, located
|
45
45
|
at
|
@@ -75,11 +75,11 @@ Archives: \c
|
|
75
75
|
.UE \c
|
76
76
|
.RE
|
77
77
|
.SH COPYRIGHT
|
78
|
-
Copyright © 2006
|
78
|
+
Copyright © 2006\-2009 William Morgan \c
|
79
79
|
.MT mworgan-sup@masanjin.net
|
80
80
|
.ME \c
|
81
81
|
.PP
|
82
|
-
Copyright \[at] 2013
|
82
|
+
Copyright \[at] 2013\-2014 Sup developers
|
83
83
|
.PP
|
84
84
|
Permission is granted to copy and distribute this manual under the terms
|
85
85
|
of the GNU General Public License; either version 2 or (at your option)
|
@@ -1,21 +1,21 @@
|
|
1
|
-
.\" Automatically generated by Pandoc 3.1.
|
1
|
+
.\" Automatically generated by Pandoc 3.1.11.1
|
2
2
|
.\"
|
3
|
-
.TH "SUP
|
3
|
+
.TH "SUP\-SYNC" "1" "September 3, 2014" "Sup User Manual" ""
|
4
4
|
.SH NAME
|
5
|
-
sup
|
5
|
+
sup\-psych\-ify\-config\-files \- migrate Sup configuration
|
6
6
|
.SH SYNOPSIS
|
7
|
-
sup
|
7
|
+
sup\-psych\-ify\-config\-files
|
8
8
|
.SH DESCRIPTION
|
9
9
|
\f[B]YAML migration is deprecated by Ruby 2.1 and newer.\f[R]
|
10
10
|
.PP
|
11
|
-
If sup
|
12
|
-
\f[I]$HOME/.sup/sources.yaml\f[R] configuration file by reading it
|
13
|
-
the SYCK YAML parser and emitting the results with the Psych YAML
|
11
|
+
If sup\-psych\-ify\-config\-files is executed by Ruby <= 2.0 it migrates
|
12
|
+
the \f[I]$HOME/.sup/sources.yaml\f[R] configuration file by reading it
|
13
|
+
with the SYCK YAML parser and emitting the results with the Psych YAML
|
14
14
|
emitter.
|
15
15
|
.PP
|
16
16
|
Read more on the Sup wiki
|
17
17
|
.PP
|
18
|
-
https://github.com/sup
|
18
|
+
https://github.com/sup\-heliotrope/sup/wiki/Migration\-0.13\-to\-0.14
|
19
19
|
.SH FILES
|
20
20
|
.TP
|
21
21
|
$HOME/.sup/config.yaml
|
@@ -24,7 +24,7 @@ Sup configuration file
|
|
24
24
|
$HOME/.sup/sources.yaml
|
25
25
|
Configuration file for Sup mail sources
|
26
26
|
.SH SEE ALSO
|
27
|
-
sup(1), sup
|
27
|
+
sup(1), sup\-add(1), sup\-config(1), sup\-dump(1)
|
28
28
|
.SH REPORTING BUGS
|
29
29
|
You are welcome to submit bug reports to the Sup issue tracker, located
|
30
30
|
at
|
@@ -60,11 +60,11 @@ Archives: \c
|
|
60
60
|
.UE \c
|
61
61
|
.RE
|
62
62
|
.SH COPYRIGHT
|
63
|
-
Copyright © 2006
|
63
|
+
Copyright © 2006\-2009 William Morgan \c
|
64
64
|
.MT mworgan-sup@masanjin.net
|
65
65
|
.ME \c
|
66
66
|
.PP
|
67
|
-
Copyright \[at] 2013
|
67
|
+
Copyright \[at] 2013\-2014 Sup developers
|
68
68
|
.PP
|
69
69
|
Permission is granted to copy and distribute this manual under the terms
|
70
70
|
of the GNU General Public License; either version 2 or (at your option)
|
data/man/sup-recover-sources.1
CHANGED
@@ -1,49 +1,49 @@
|
|
1
|
-
.\" Automatically generated by Pandoc 3.1.
|
1
|
+
.\" Automatically generated by Pandoc 3.1.11.1
|
2
2
|
.\"
|
3
|
-
.TH "SUP
|
3
|
+
.TH "SUP\-RECOVER\-SOURCES" "1" "April 9, 2012" "Sup User Manual" ""
|
4
4
|
.SH NAME
|
5
|
-
sup
|
5
|
+
sup\-recover\-sources \- rebuild a lost Sup source configuration file
|
6
6
|
.SH SYNOPSIS
|
7
|
-
sup
|
7
|
+
sup\-recover\-sources [\f[I]options\f[R]] [\f[I]source uri\&...\f[R]]
|
8
8
|
.SH DESCRIPTION
|
9
9
|
Rebuilds a lost sources.yaml file by reading messages from a list of
|
10
10
|
sources and determining, for each source, the most prevalent `source_id'
|
11
11
|
field of messages from that source in the index.
|
12
12
|
.PP
|
13
|
-
The only non
|
14
|
-
appears in multiple sources, those sources may be mis
|
15
|
-
program.
|
13
|
+
The only non\-deterministic component to this is that if the same
|
14
|
+
message appears in multiple sources, those sources may be mis\-diagnosed
|
15
|
+
by this program.
|
16
16
|
.PP
|
17
|
-
If the first N messages (
|
18
|
-
in the index, the source will be added to sources.yaml.
|
17
|
+
If the first N messages (\-\-scan\-num below) all have the same
|
18
|
+
source_id in the index, the source will be added to sources.yaml.
|
19
19
|
Otherwise, the distribution will be printed, and you will have to add it
|
20
20
|
by hand.
|
21
21
|
.PP
|
22
22
|
The offset pointer into the sources will be set to the end of the
|
23
|
-
source, so you will have to run sup
|
24
|
-
after doing this.
|
23
|
+
source, so you will have to run sup\-import \-\-rebuild for each new
|
24
|
+
source after doing this.
|
25
25
|
.SH OPTIONS
|
26
26
|
.TP
|
27
|
-
|
27
|
+
\-\-unusual
|
28
28
|
Mark sources as `unusual'.
|
29
29
|
Only usual sources will be polled by hand (default: false)
|
30
30
|
.TP
|
31
|
-
|
31
|
+
\-\-archive
|
32
32
|
Mark sources as `archive'.
|
33
33
|
New messages from these sources will not appear in the inbox (default:
|
34
34
|
false)
|
35
35
|
.TP
|
36
|
-
|
36
|
+
\-\-scan\-num N
|
37
37
|
Number of messages to scan per source (default: 10)
|
38
38
|
.TP
|
39
|
-
|
39
|
+
\-h, \-\-help
|
40
40
|
Show help message
|
41
41
|
.SH FILES
|
42
42
|
.TP
|
43
43
|
$HOME/.sup/sources.yaml
|
44
44
|
Configuration file for Sup mail sources
|
45
45
|
.SH SEE ALSO
|
46
|
-
sup(1), sup
|
46
|
+
sup(1), sup\-config(1), sup\-add(1), sup\-import(1)
|
47
47
|
.SH REPORTING BUGS
|
48
48
|
You are welcome to submit bug reports to the Sup issue tracker, located
|
49
49
|
at
|
@@ -79,11 +79,11 @@ Archives: \c
|
|
79
79
|
.UE \c
|
80
80
|
.RE
|
81
81
|
.SH COPYRIGHT
|
82
|
-
Copyright © 2006
|
82
|
+
Copyright © 2006\-2009 William Morgan \c
|
83
83
|
.MT mworgan-sup@masanjin.net
|
84
84
|
.ME \c
|
85
85
|
.PP
|
86
|
-
Copyright \[at] 2013
|
86
|
+
Copyright \[at] 2013\-2014 Sup developers
|
87
87
|
.PP
|
88
88
|
Permission is granted to copy and distribute this manual under the terms
|
89
89
|
of the GNU General Public License; either version 2 or (at your option)
|
data/man/sup-sync-back-maildir.1
CHANGED
@@ -1,24 +1,25 @@
|
|
1
|
-
.\" Automatically generated by Pandoc 3.1.
|
1
|
+
.\" Automatically generated by Pandoc 3.1.11.1
|
2
2
|
.\"
|
3
|
-
.TH "SUP
|
3
|
+
.TH "SUP\-SYNC\-BACK\-MAILDIR" "1" "August 25, 2014" "Sup User Manual" ""
|
4
4
|
.SH NAME
|
5
|
-
sup
|
5
|
+
sup\-sync\-back\-maildir \- Export Xapian entries to Maildir sources on
|
6
|
+
disk
|
6
7
|
.SH SYNOPSIS
|
7
|
-
sup
|
8
|
+
sup\-sync\-back\-maildir [\f[I]options\f[R]] [\f[I]source uri\&...\f[R]]
|
8
9
|
.SH DESCRIPTION
|
9
10
|
This script parses the Xapian entries for a given Maildir source and
|
10
|
-
renames (changes maildir flags) e
|
11
|
+
renames (changes maildir flags) e\-mail files on disk according to the
|
11
12
|
labels stored in the index.
|
12
13
|
It will export all the changes you made in Sup to your Maildirs so that
|
13
14
|
they can be propagated to your IMAP server with e.g.\ offlineimap.
|
14
15
|
.PP
|
15
16
|
The script also merges some Maildir flags into Sup such as R (replied)
|
16
|
-
and P (passed, forwarded), for instance suppose you have an e
|
17
|
+
and P (passed, forwarded), for instance suppose you have an e\-mail file
|
17
18
|
like this: foo_bar:2,FRS (flags are favorite, replied, seen) and its
|
18
19
|
Xapian entry has labels `starred', the merge operation will add the
|
19
20
|
`replied' label to the Xapian entry.
|
20
21
|
.PP
|
21
|
-
If you choose not to merge (
|
22
|
+
If you choose not to merge (\-m) you will lose information (`replied'),
|
22
23
|
and in the previous example the file will be renamed to foo_bar:2,FS.
|
23
24
|
.PP
|
24
25
|
Running this script is \f[I]strongly\f[R] recommended when setting the
|
@@ -31,30 +32,30 @@ sources marked as usual and that have not disabled sync back using the
|
|
31
32
|
configuration parameter sync_back = false in sources.yaml.
|
32
33
|
.SH OPTIONS
|
33
34
|
.TP
|
34
|
-
|
35
|
+
\-n, \-\-no\-confirm
|
35
36
|
Don\[cq]t ask for confirmation before synchronizing
|
36
37
|
.TP
|
37
|
-
|
38
|
+
\-m, \-\-no\-merge
|
38
39
|
Don\[cq]t merge new supported Maildir flags (R and P)
|
39
40
|
.TP
|
40
|
-
|
41
|
+
\-l, \-\-list\-sources
|
41
42
|
List your Maildir sources and exit
|
42
43
|
.TP
|
43
|
-
|
44
|
+
\-u, \-\-unusual\-sources\-too
|
44
45
|
Sync unusual sources too if no specific source information is given
|
45
46
|
.TP
|
46
|
-
|
47
|
+
\-\-version
|
47
48
|
Print version and exit
|
48
49
|
.TP
|
49
|
-
|
50
|
+
\-h, \-\-help
|
50
51
|
Show brief help message
|
51
52
|
.SH FILES
|
52
53
|
.TP
|
53
54
|
$HOME/.sup/sources.yaml
|
54
55
|
Configuration file for Sup mail sources
|
55
56
|
.SH SEE ALSO
|
56
|
-
sup(1), sup
|
57
|
-
sup
|
57
|
+
sup(1), sup\-add(1), sup\-config(1), sup\-dump(1), sup\-sync(1),
|
58
|
+
sup\-tweak\-labels(1)
|
58
59
|
.SH REPORTING BUGS
|
59
60
|
You are welcome to submit bug reports to the Sup issue tracker, located
|
60
61
|
at
|
@@ -90,11 +91,11 @@ Archives: \c
|
|
90
91
|
.UE \c
|
91
92
|
.RE
|
92
93
|
.SH COPYRIGHT
|
93
|
-
Copyright © 2006
|
94
|
+
Copyright © 2006\-2009 William Morgan \c
|
94
95
|
.MT mworgan-sup@masanjin.net
|
95
96
|
.ME \c
|
96
97
|
.PP
|
97
|
-
Copyright \[at] 2013
|
98
|
+
Copyright \[at] 2013\-2014 Sup developers
|
98
99
|
.PP
|
99
100
|
Permission is granted to copy and distribute this manual under the terms
|
100
101
|
of the GNU General Public License; either version 2 or (at your option)
|
data/man/sup-sync.1
CHANGED
@@ -1,79 +1,79 @@
|
|
1
|
-
.\" Automatically generated by Pandoc 3.1.
|
1
|
+
.\" Automatically generated by Pandoc 3.1.11.1
|
2
2
|
.\"
|
3
|
-
.TH "SUP
|
3
|
+
.TH "SUP\-SYNC" "1" "April 9, 2012" "Sup User Manual" ""
|
4
4
|
.SH NAME
|
5
|
-
sup
|
5
|
+
sup\-sync \- sychronize the Sup index with message sources
|
6
6
|
.SH SYNOPSIS
|
7
|
-
sup
|
7
|
+
sup\-sync [\f[I]options\f[R]] source \&...
|
8
8
|
.SH DESCRIPTION
|
9
9
|
Synchronizes the Sup index with one or more message sources by adding
|
10
10
|
messages, deleting messages, or changing message state in the index as
|
11
11
|
appropriate.
|
12
12
|
.PP
|
13
13
|
\[lq]Message state\[rq] means read/unread, archived/inbox,
|
14
|
-
starred/unstarred, and all user
|
14
|
+
starred/unstarred, and all user\-defined labels on each message.
|
15
15
|
.PP
|
16
16
|
\[lq]Default source state\[rq] refers to any state that a source itself
|
17
17
|
has keeps about a message.
|
18
|
-
Sup
|
18
|
+
Sup\-sync uses this information when adding a new message to the index.
|
19
19
|
The source state is typically limited to read/unread, archived/inbox
|
20
20
|
status and a single label based on the source name.
|
21
21
|
Messages using the default source state are placed in the inbox
|
22
22
|
(i.e.\ not archived) and unstarred.
|
23
23
|
.PP
|
24
24
|
If no sources are given, sync from all usual sources.
|
25
|
-
Supported source URI schemes can be seen by running \[lq]sup
|
26
|
-
|
25
|
+
Supported source URI schemes can be seen by running \[lq]sup\-add
|
26
|
+
\-\-help\[rq].
|
27
27
|
.SH MESSAGE STATE OPTIONS
|
28
28
|
.TP
|
29
|
-
|
29
|
+
\-\-asis
|
30
30
|
If the message is already in the index, preserve its state.
|
31
31
|
Otherwise, use default source state (default)
|
32
32
|
.TP
|
33
|
-
|
34
|
-
Restore message state from a dump file created with sup
|
35
|
-
If a message is not in this dumpfile, act as
|
33
|
+
\-\-restore dumpfile
|
34
|
+
Restore message state from a dump file created with sup\-dump.
|
35
|
+
If a message is not in this dumpfile, act as \-\-asis
|
36
36
|
.TP
|
37
|
-
|
37
|
+
\-\-discard
|
38
38
|
Discard any message state in the index and use the default source state.
|
39
39
|
\f[B]Dangerous!\f[R]
|
40
40
|
.TP
|
41
|
-
|
41
|
+
\-x, \-
|
42
42
|
When using the default source state, mark messages as archived.
|
43
43
|
.TP
|
44
|
-
|
44
|
+
\-r, \-\-read
|
45
45
|
When using the default source state, mark messages as read.
|
46
46
|
.TP
|
47
|
-
|
48
|
-
When using the default source state, also apply these user
|
49
|
-
labels (a comma
|
47
|
+
\-\-extra\-labels \f[I]STRING\f[R]
|
48
|
+
When using the default source state, also apply these user\-defined
|
49
|
+
labels (a comma\-separated list) (default)
|
50
50
|
.SH OTHER OPTIONS
|
51
51
|
.TP
|
52
|
-
|
52
|
+
\-v, \-\-verbose
|
53
53
|
Print message ids as they\[cq]re processed.
|
54
54
|
.TP
|
55
|
-
|
55
|
+
\-o, \-\-optimize
|
56
56
|
As the final operation, optimize the index.
|
57
57
|
.TP
|
58
|
-
|
58
|
+
\-\-all\-sources
|
59
59
|
Scan over all sources.
|
60
60
|
.TP
|
61
|
-
|
61
|
+
\-n, \-\-dry\-run
|
62
62
|
Don\[cq]t actually modify the index.
|
63
|
-
Probably only useful with
|
63
|
+
Probably only useful with \-\-verbose.
|
64
64
|
.TP
|
65
|
-
|
65
|
+
\-\-version
|
66
66
|
Show version information
|
67
67
|
.TP
|
68
|
-
|
68
|
+
\-h, \-\-help
|
69
69
|
Show help message
|
70
70
|
.SH FILES
|
71
71
|
.TP
|
72
72
|
$HOME/.sup/sources.yaml
|
73
73
|
Configuration file for Sup mail sources
|
74
74
|
.SH SEE ALSO
|
75
|
-
sup(1), sup
|
76
|
-
sup
|
75
|
+
sup(1), sup\-add(1), sup\-config(1), sup\-dump(1),
|
76
|
+
sup\-sync\-back\-maildir(1), sup\-tweak\-labels(1)
|
77
77
|
.SH REPORTING BUGS
|
78
78
|
You are welcome to submit bug reports to the Sup issue tracker, located
|
79
79
|
at
|
@@ -109,11 +109,11 @@ Archives: \c
|
|
109
109
|
.UE \c
|
110
110
|
.RE
|
111
111
|
.SH COPYRIGHT
|
112
|
-
Copyright © 2006
|
112
|
+
Copyright © 2006\-2009 William Morgan \c
|
113
113
|
.MT mworgan-sup@masanjin.net
|
114
114
|
.ME \c
|
115
115
|
.PP
|
116
|
-
Copyright \[at] 2013
|
116
|
+
Copyright \[at] 2013\-2014 Sup developers
|
117
117
|
.PP
|
118
118
|
Permission is granted to copy and distribute this manual under the terms
|
119
119
|
of the GNU General Public License; either version 2 or (at your option)
|