vmail 2.9.0 → 2.9.1
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.
- data/README.markdown +33 -28
- data/lib/vmail/imap_client.rb +1 -1
- data/lib/vmail/version.rb +1 -1
- metadata +3 -2
data/README.markdown
CHANGED
@@ -39,7 +39,7 @@ Test your installation by typing `vmail -h`. You should see Vmail's help.
|
|
39
39
|
|
40
40
|
On some systems you may run into a PATH issue, where the system can't find the
|
41
41
|
`vmail` command after installation. Please report this if you encounter this
|
42
|
-
problem, and mention what system you're using. You might want to try
|
42
|
+
problem, and mention what system you're using. You might want to try
|
43
43
|
|
44
44
|
sudo gem install vmail
|
45
45
|
|
@@ -72,7 +72,7 @@ The `.vmailrc` file should look something like this. Substitute your own values.
|
|
72
72
|
password: password
|
73
73
|
name: Daniel Choi
|
74
74
|
signature: |
|
75
|
-
--
|
75
|
+
--
|
76
76
|
Sent from Vmail. http://danielchoi.com/software/vmail.html
|
77
77
|
|
78
78
|
This file should be formatted in [YAML syntax][1]. If you have any unsual
|
@@ -110,6 +110,11 @@ configuration options][firewall] that you can use.
|
|
110
110
|
|
111
111
|
[firewall]:https://github.com/danchoi/vmail/wiki/How-to-use-vmail-behind-a-firewall-that-blocks-IMAP
|
112
112
|
|
113
|
+
If you have a non English(US) Gmail account, you would need a little
|
114
|
+
[extra configuration][non_english] to make Vmail work.
|
115
|
+
|
116
|
+
[non_english]:https://github.com/danchoi/vmail/wiki/Non-English(US)-Gmail-accounts
|
117
|
+
|
113
118
|
Another optional parameter is `date_format`, which controls the appearance of
|
114
119
|
the dates in the message list. Here you can use a strptime-compatible date
|
115
120
|
format string. Make sure you enclose these in quotes:
|
@@ -124,7 +129,7 @@ To use this feature, generate a `vmail-contacts.txt` file. This is a
|
|
124
129
|
simple list of your email contacts. Invoking Vmail with the `-g` option
|
125
130
|
generates this file for you by collecting all the recipients and cc's
|
126
131
|
from your last 500 sent emails. You can adjust this number by using `-g`
|
127
|
-
with a number argument.
|
132
|
+
with a number argument.
|
128
133
|
|
129
134
|
After Vmail generates this file for you, you can edit it however and whenever
|
130
135
|
you want, as long as there is one address per line.
|
@@ -221,7 +226,7 @@ To save you keystrokes, Vmail provides alternative key mappings for
|
|
221
226
|
* trash/delete: `,#` → `,3`
|
222
227
|
* mark spam: `,!` → `,1`
|
223
228
|
|
224
|
-
These save you from having to press the SHIFT key in each case.
|
229
|
+
These save you from having to press the SHIFT key in each case.
|
225
230
|
|
226
231
|
## Checking for new messages, INBOX polling
|
227
232
|
|
@@ -237,7 +242,7 @@ you will still have to manually check for new messages in the Vmail
|
|
237
242
|
interface to force the new messages to display.
|
238
243
|
|
239
244
|
To enable automatic inbox polling put the line `polling: true` in your `.vmailrc`.
|
240
|
-
|
245
|
+
|
241
246
|
## Switching mailboxes, moving messages, copying messages to another mailbox
|
242
247
|
|
243
248
|
To switch mailboxes, type `,m`. You'll see an autocomplete window appear at the top.
|
@@ -248,7 +253,7 @@ The standard Vim autocomplete keystrokes apply:
|
|
248
253
|
* `C-u`: when the match list is active, cycles forward through the match list and what you've typed so far; when the match list is inactive, erases what you've typed.
|
249
254
|
* `C-x C-u` finds matches for what you've typed so far (when the match list window is closed)
|
250
255
|
* `C-y` selects the highlighted match without triggering ENTER
|
251
|
-
* ENTER selects the highlighted match from the match list
|
256
|
+
* ENTER selects the highlighted match from the match list
|
252
257
|
|
253
258
|
Tip: start typing the first 1-3 characters of the mailbox name, then press
|
254
259
|
`C-n`, `C-u` or `C-p` until you highlight the right match, and finally press ENTER to
|
@@ -302,9 +307,9 @@ blank line between the headers and the body of your message.
|
|
302
307
|
When you're done writing, send the message by typing `,vs` in normal mode.
|
303
308
|
|
304
309
|
While you're composing a message in the composition window, you can save a
|
305
|
-
draft to a local file with the standard Vim `:w` command:
|
310
|
+
draft to a local file with the standard Vim `:w` command:
|
306
311
|
|
307
|
-
:w my_draft_filename.txt
|
312
|
+
:w my_draft_filename.txt
|
308
313
|
|
309
314
|
Make sure you append *.txt to the filename, or else Vmail won't recognize it as
|
310
315
|
a potential email when you reload it.
|
@@ -326,7 +331,7 @@ you've composed with correct headers and saved to a file, like so:
|
|
326
331
|
vmailsend < my_message.txt
|
327
332
|
|
328
333
|
vmailsend uses your `.vmailrc` configuration and assumes that you saved your
|
329
|
-
password in it.
|
334
|
+
password in it.
|
330
335
|
|
331
336
|
## Attachments
|
332
337
|
|
@@ -356,28 +361,28 @@ composition window:
|
|
356
361
|
from: Daniel Choi <dhchoi@gmail.com>
|
357
362
|
to: barackobama@whitehouse.gov
|
358
363
|
subject: look at this!
|
359
|
-
|
364
|
+
|
360
365
|
attach: images/middle-east-map.png
|
361
366
|
attach: images/policypaper.pdf
|
362
367
|
attach: docs/
|
363
|
-
|
368
|
+
|
364
369
|
I think you'll find this stuff interesting.
|
365
|
-
|
370
|
+
|
366
371
|
The items following the `attach:` directives are paths (either relative to the
|
367
372
|
current directory or absolute) to the files you want to attach to your message.
|
368
373
|
Note that you can also specify a directory, in which case Vmail attaches every
|
369
|
-
file it finds in that directory. Make sure that you
|
374
|
+
file it finds in that directory. Make sure that you
|
370
375
|
|
371
376
|
* keep the `attach:` lines contiguous (no intervening empty lines) if you want to add multiple attachments
|
372
377
|
* insert an empty line before the attachments section
|
373
378
|
* insert an empty after the attachments section
|
374
379
|
|
375
|
-
You don't have to type the `attach:` directives manually. You can use the
|
380
|
+
You don't have to type the `attach:` directives manually. You can use the
|
376
381
|
command `:VMAttach [filename-or-path]` to insert an `attach:` directive with
|
377
382
|
the help of file auto-completion.
|
378
383
|
|
379
384
|
One thing Vmail doesn't do yet is let you forward a message with all its
|
380
|
-
attachments intact. This feature will be implemented in the near future.
|
385
|
+
attachments intact. This feature will be implemented in the near future.
|
381
386
|
|
382
387
|
## Printing messages to a file
|
383
388
|
|
@@ -406,40 +411,40 @@ before you start Vmail, e.g.:
|
|
406
411
|
Also, if your Vim has `netrw` (`:help netrw`), you can open a hyperlink
|
407
412
|
directly in same Vim window by putting the cursor at the beginning of a
|
408
413
|
hyperlink and typing `gf`, or `C-w f` if you want to open the webpage in a
|
409
|
-
split window.
|
414
|
+
split window.
|
410
415
|
|
411
416
|
## Search queries
|
412
417
|
|
413
418
|
Vmail can generate a message list by performing an IMAP search on the current mailbox.
|
414
|
-
From the message list window, type `,s`. This will prompt you for a search query.
|
419
|
+
From the message list window, type `,s`. This will prompt you for a search query.
|
415
420
|
The search query should be a valid IMAP search query.
|
416
421
|
|
417
422
|
Here are some example search queries.
|
418
423
|
|
419
|
-
# the default
|
420
|
-
all
|
424
|
+
# the default
|
425
|
+
all
|
421
426
|
|
422
427
|
# all messages from thematrix.com domain
|
423
|
-
from thematrix.com
|
428
|
+
from thematrix.com
|
424
429
|
|
425
430
|
# all messages from this person
|
426
|
-
from barackobama@whitehouse.gov
|
431
|
+
from barackobama@whitehouse.gov
|
427
432
|
|
428
433
|
# you can also omit the host part of the email address
|
429
434
|
from barackobama
|
430
435
|
|
431
436
|
# you can also search by the full name, first name, or last name associated
|
432
|
-
# with an email; use double quotes to enclose multiple words
|
437
|
+
# with an email; use double quotes to enclose multiple words
|
433
438
|
cc "David Fisher"
|
434
439
|
|
435
440
|
# subject field search; use double quotes to enclose multiple words
|
436
|
-
subject "unix philosophy"
|
441
|
+
subject "unix philosophy"
|
437
442
|
|
438
443
|
# message body search; use double quotes to enclose multiple words
|
439
|
-
body "unix philosophy"
|
444
|
+
body "unix philosophy"
|
440
445
|
|
441
446
|
# example of date range and multiple conditions
|
442
|
-
before 30-nov-2010 since 1-nov-2010 from prx.org
|
447
|
+
before 30-nov-2010 since 1-nov-2010 from prx.org
|
443
448
|
|
444
449
|
# search for all messages since 1-nov-2010 larger than 10k
|
445
450
|
# (note that queries with size conditions seem to take longer to return)
|
@@ -483,7 +488,7 @@ the default `VMAIL_HOME`. Vmail places these files in it:
|
|
483
488
|
|
484
489
|
* `current_message.txt` holds the current message being shown. Not deleted on quit.
|
485
490
|
|
486
|
-
* `part.html` is created if you open an HTML mail part from Vmail.
|
491
|
+
* `part.html` is created if you open an HTML mail part from Vmail.
|
487
492
|
|
488
493
|
Finally, Vmail logs output to a `vmail.log` file which it creates in the
|
489
494
|
current directory. You can tail this file in a separate terminal window to see
|
@@ -505,7 +510,7 @@ You can also be sure that the Vmail code doesn't do anything nefarious with
|
|
505
510
|
your Gmail password because Vmail is open source. Anyone can inspect the source
|
506
511
|
code of the copy of Vmail that runs on your computer and inspect the latest
|
507
512
|
Vmail code at the [github repository][github] and at [rubygems.org][rubygems] (where the
|
508
|
-
`vmail` gem is downloaded from).
|
513
|
+
`vmail` gem is downloaded from).
|
509
514
|
|
510
515
|
[github]:https://github.com/danchoi/vmail
|
511
516
|
[rubygems]:https://rubygems.org/gems/vmail
|
@@ -525,7 +530,7 @@ up. In that case, just force a redraw of the Vim screen with `C-l`.
|
|
525
530
|
By default, Vmail highlights starred messages in bold green against a black
|
526
531
|
background. You can customize this setting by adding a line to your `~/.vimrc`
|
527
532
|
(not `.vmailrc`) file like so:
|
528
|
-
|
533
|
+
|
529
534
|
let g:vmail_flagged_color = "ctermfg=yellow ctermbg=black cterm=bold"
|
530
535
|
|
531
536
|
Type `:help highlight-args` in Vim for more details.
|
data/lib/vmail/imap_client.rb
CHANGED
@@ -223,7 +223,7 @@ module Vmail
|
|
223
223
|
}
|
224
224
|
log "- got seqnos: #{ids.inspect}"
|
225
225
|
log "- getting seqnos > #{self.max_seqno}"
|
226
|
-
new_ids = ids.select {|seqno| seqno > self.max_seqno}
|
226
|
+
new_ids = ids.select {|seqno| seqno.to_i > self.max_seqno}
|
227
227
|
# reset the max_seqno
|
228
228
|
self.max_seqno = ids.max
|
229
229
|
log "- setting max_seqno to #{self.max_seqno}"
|
data/lib/vmail/version.rb
CHANGED
metadata
CHANGED
@@ -1,7 +1,7 @@
|
|
1
1
|
--- !ruby/object:Gem::Specification
|
2
2
|
name: vmail
|
3
3
|
version: !ruby/object:Gem::Version
|
4
|
-
version: 2.9.
|
4
|
+
version: 2.9.1
|
5
5
|
prerelease:
|
6
6
|
platform: ruby
|
7
7
|
authors:
|
@@ -9,7 +9,7 @@ authors:
|
|
9
9
|
autorequire:
|
10
10
|
bindir: bin
|
11
11
|
cert_chain: []
|
12
|
-
date: 2014-
|
12
|
+
date: 2014-07-17 00:00:00.000000000 Z
|
13
13
|
dependencies:
|
14
14
|
- !ruby/object:Gem::Dependency
|
15
15
|
name: mail
|
@@ -176,3 +176,4 @@ signing_key:
|
|
176
176
|
specification_version: 3
|
177
177
|
summary: A Vim interface to Gmail
|
178
178
|
test_files: []
|
179
|
+
has_rdoc:
|