vmail 2.9.0 → 2.9.1
Sign up to get free protection for your applications and to get access to all the features.
- 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:
|