vmail 1.2.4 → 1.2.5

data/README.markdown

@@ -111,7 +111,7 @@ startup by passing in the mailbox name as an argument:
 
     vmail starred
 
-You can also pass in search parameters:
+You can also pass in search parameters after specifying the mailbox:
 
     vmail important from barackobama@whitehouse.gov
 
@@ -365,7 +365,6 @@ directly in same Vim window by putting the cursor at the beginning of a
 hyperlink and typing `gf`, or `C-w f` if you want to open the webpage in a
 split window. 
 
-
 ## Search queries
 
 vmail can generate a message list by performing an IMAP search on the current mailbox.
@@ -411,6 +410,36 @@ navigate the search query history. `<C-f>` opens a mini-editor that contains
 the current query plus a history of previous vmail search queries. You can edit
 any line in this mini-editor and press ENTER to perform the query on that line.
 
+## Command line mode and batch processing
+
+You can invoke vmail in non-interactive mode to perform batch
+processing.
+
+If you redirect vmail's output from STDOUT to a file, vmail will output
+the message list resulting from a search query to a file.
+
+    vmail inbox 100 from monit > monit-emails.txt 
+
+You can open this file in any text editor to make sure that the search
+query produced the expected result. Then you can perform the following
+batch operations on the message list:
+
+    # deletes all the messages in the message list
+    vmail rm < monit-emails.txt
+
+    # marks all the messages in the message list as spam
+    vmail spam < monit-emails.txt
+
+    # moves all the messages in the message list to the 'monit' mailbox
+    vmail mv monit < monit-emails.txt
+
+    # copies all the messages in the message list to the 'monit' mailbox
+    vmail cp monit < monit-emails.txt
+
+    # prints all the messages in the message list to 'monit.txt' 
+    vmail print monit.txt < monit-emails.txt
+
+
 ## Getting help
 
 Typing `,?` will open this webpage in a browser.

data/lib/vmail.rb

@@ -113,7 +113,7 @@ module Vmail
       'spam' => ["flag", "+FLAGS", "spam"],
       'mv' => ["move_to"],
       'cp' => ["copy_to"],
-      'cat' => ["append_to_file"]
+      'print' => ["append_to_file"]
     }
     args = commands[ARGV.first]
     if args.nil?

data/lib/vmail/version.rb

@@ -1,3 +1,3 @@
 module Vmail
-  VERSION = "1.2.4"
+  VERSION = "1.2.5"
 end

metadata

@@ -5,8 +5,8 @@ version: !ruby/object:Gem::Version
   segments: 
   - 1
   - 2
-  - 4
-  version: 1.2.4
+  - 5
+  version: 1.2.5
 platform: ruby
 authors: 
 - Daniel Choi
@@ -14,7 +14,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2011-01-08 00:00:00 -05:00
+date: 2011-01-09 00:00:00 -05:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency