vmail 0.0.7 → 0.0.8

data/website/lightbox2/js/scriptaculous.js

@@ -0,0 +1,58 @@
+// script.aculo.us scriptaculous.js v1.8.1, Thu Jan 03 22:07:12 -0500 2008
+
+// Copyright (c) 2005-2007 Thomas Fuchs (http://script.aculo.us, http://mir.aculo.us)
+// 
+// Permission is hereby granted, free of charge, to any person obtaining
+// a copy of this software and associated documentation files (the
+// "Software"), to deal in the Software without restriction, including
+// without limitation the rights to use, copy, modify, merge, publish,
+// distribute, sublicense, and/or sell copies of the Software, and to
+// permit persons to whom the Software is furnished to do so, subject to
+// the following conditions:
+// 
+// The above copyright notice and this permission notice shall be
+// included in all copies or substantial portions of the Software.
+//
+// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+// MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+// LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+// OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+// WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+//
+// For details, see the script.aculo.us web site: http://script.aculo.us/
+
+var Scriptaculous = {
+  Version: '1.8.1',
+  require: function(libraryName) {
+    // inserting via DOM fails in Safari 2.0, so brute force approach
+    document.write('<script type="text/javascript" src="'+libraryName+'"><\/script>');
+  },
+  REQUIRED_PROTOTYPE: '1.6.0',
+  load: function() {
+    function convertVersionString(versionString){
+      var r = versionString.split('.');
+      return parseInt(r[0])*100000 + parseInt(r[1])*1000 + parseInt(r[2]);
+    }
+ 
+    if((typeof Prototype=='undefined') || 
+       (typeof Element == 'undefined') || 
+       (typeof Element.Methods=='undefined') ||
+       (convertVersionString(Prototype.Version) < 
+        convertVersionString(Scriptaculous.REQUIRED_PROTOTYPE)))
+       throw("script.aculo.us requires the Prototype JavaScript framework >= " +
+        Scriptaculous.REQUIRED_PROTOTYPE);
+    
+    $A(document.getElementsByTagName("script")).findAll( function(s) {
+      return (s.src && s.src.match(/scriptaculous\.js(\?.*)?$/))
+    }).each( function(s) {
+      var path = s.src.replace(/scriptaculous\.js(\?.*)?$/,'');
+      var includes = s.src.match(/\?.*load=([a-z,]*)/);
+      (includes ? includes[1] : 'builder,effects,dragdrop,controls,slider,sound').split(',').each(
+       function(include) { Scriptaculous.require(path+include+'.js') });
+    });
+  }
+}
+
+Scriptaculous.load();

data/website/stylesheets-vmail/960.css

@@ -0,0 +1 @@
+.container_12,.container_16{margin-left:auto;margin-right:auto;width:960px}.grid_1,.grid_2,.grid_3,.grid_4,.grid_5,.grid_6,.grid_7,.grid_8,.grid_9,.grid_10,.grid_11,.grid_12,.grid_13,.grid_14,.grid_15,.grid_16{display:inline;float:left;position:relative;margin-left:10px;margin-right:10px}.container_12 .grid_3,.container_16 .grid_4{width:220px}.container_12 .grid_6,.container_16 .grid_8{width:460px}.container_12 .grid_9,.container_16 .grid_12{width:700px}.container_12 .grid_12,.container_16 .grid_16{width:940px}.alpha{margin-left:0}.omega{margin-right:0}.container_12 .grid_1{width:60px}.container_12 .grid_2{width:140px}.container_12 .grid_4{width:300px}.container_12 .grid_5{width:380px}.container_12 .grid_7{width:540px}.container_12 .grid_8{width:620px}.container_12 .grid_10{width:780px}.container_12 .grid_11{width:860px}.container_16 .grid_1{width:40px}.container_16 .grid_2{width:100px}.container_16 .grid_3{width:160px}.container_16 .grid_5{width:280px}.container_16 .grid_6{width:340px}.container_16 .grid_7{width:400px}.container_16 .grid_9{width:520px}.container_16 .grid_10{width:580px}.container_16 .grid_11{width:640px}.container_16 .grid_13{width:760px}.container_16 .grid_14{width:820px}.container_16 .grid_15{width:880px}.container_12 .prefix_3,.container_16 .prefix_4{padding-left:240px}.container_12 .prefix_6,.container_16 .prefix_8{padding-left:480px}.container_12 .prefix_9,.container_16 .prefix_12{padding-left:720px}.container_12 .prefix_1{padding-left:80px}.container_12 .prefix_2{padding-left:160px}.container_12 .prefix_4{padding-left:320px}.container_12 .prefix_5{padding-left:400px}.container_12 .prefix_7{padding-left:560px}.container_12 .prefix_8{padding-left:640px}.container_12 .prefix_10{padding-left:800px}.container_12 .prefix_11{padding-left:880px}.container_16 .prefix_1{padding-left:60px}.container_16 .prefix_2{padding-left:120px}.container_16 .prefix_3{padding-left:180px}.container_16 .prefix_5{padding-left:300px}.container_16 .prefix_6{padding-left:360px}.container_16 .prefix_7{padding-left:420px}.container_16 .prefix_9{padding-left:540px}.container_16 .prefix_10{padding-left:600px}.container_16 .prefix_11{padding-left:660px}.container_16 .prefix_13{padding-left:780px}.container_16 .prefix_14{padding-left:840px}.container_16 .prefix_15{padding-left:900px}.container_12 .suffix_3,.container_16 .suffix_4{padding-right:240px}.container_12 .suffix_6,.container_16 .suffix_8{padding-right:480px}.container_12 .suffix_9,.container_16 .suffix_12{padding-right:720px}.container_12 .suffix_1{padding-right:80px}.container_12 .suffix_2{padding-right:160px}.container_12 .suffix_4{padding-right:320px}.container_12 .suffix_5{padding-right:400px}.container_12 .suffix_7{padding-right:560px}.container_12 .suffix_8{padding-right:640px}.container_12 .suffix_10{padding-right:800px}.container_12 .suffix_11{padding-right:880px}.container_16 .suffix_1{padding-right:60px}.container_16 .suffix_2{padding-right:120px}.container_16 .suffix_3{padding-right:180px}.container_16 .suffix_5{padding-right:300px}.container_16 .suffix_6{padding-right:360px}.container_16 .suffix_7{padding-right:420px}.container_16 .suffix_9{padding-right:540px}.container_16 .suffix_10{padding-right:600px}.container_16 .suffix_11{padding-right:660px}.container_16 .suffix_13{padding-right:780px}.container_16 .suffix_14{padding-right:840px}.container_16 .suffix_15{padding-right:900px}.container_12 .push_3,.container_16 .push_4{left:240px}.container_12 .push_6,.container_16 .push_8{left:480px}.container_12 .push_9,.container_16 .push_12{left:720px}.container_12 .push_1{left:80px}.container_12 .push_2{left:160px}.container_12 .push_4{left:320px}.container_12 .push_5{left:400px}.container_12 .push_7{left:560px}.container_12 .push_8{left:640px}.container_12 .push_10{left:800px}.container_12 .push_11{left:880px}.container_16 .push_1{left:60px}.container_16 .push_2{left:120px}.container_16 .push_3{left:180px}.container_16 .push_5{left:300px}.container_16 .push_6{left:360px}.container_16 .push_7{left:420px}.container_16 .push_9{left:540px}.container_16 .push_10{left:600px}.container_16 .push_11{left:660px}.container_16 .push_13{left:780px}.container_16 .push_14{left:840px}.container_16 .push_15{left:900px}.container_12 .pull_3,.container_16 .pull_4{left:-240px}.container_12 .pull_6,.container_16 .pull_8{left:-480px}.container_12 .pull_9,.container_16 .pull_12{left:-720px}.container_12 .pull_1{left:-80px}.container_12 .pull_2{left:-160px}.container_12 .pull_4{left:-320px}.container_12 .pull_5{left:-400px}.container_12 .pull_7{left:-560px}.container_12 .pull_8{left:-640px}.container_12 .pull_10{left:-800px}.container_12 .pull_11{left:-880px}.container_16 .pull_1{left:-60px}.container_16 .pull_2{left:-120px}.container_16 .pull_3{left:-180px}.container_16 .pull_5{left:-300px}.container_16 .pull_6{left:-360px}.container_16 .pull_7{left:-420px}.container_16 .pull_9{left:-540px}.container_16 .pull_10{left:-600px}.container_16 .pull_11{left:-660px}.container_16 .pull_13{left:-780px}.container_16 .pull_14{left:-840px}.container_16 .pull_15{left:-900px}.clear{clear:both;display:block;overflow:hidden;visibility:hidden;width:0;height:0}.clearfix:after{clear:both;content:' ';display:block;font-size:0;line-height:0;visibility:hidden;width:0;height:0}* html .clearfix{height:1%}

data/website/stylesheets-vmail/reset.css

@@ -0,0 +1 @@
+html,body,div,span,applet,object,iframe,h1,h2,h3,h4,h5,h6,p,blockquote,pre,a,abbr,acronym,address,big,cite,code,del,dfn,em,font,img,ins,kbd,q,s,samp,small,strike,strong,sub,sup,tt,var,b,u,i,center,dl,dt,dd,ol,ul,li,fieldset,form,label,legend,table,caption,tbody,tfoot,thead,tr,th,td{margin:0;padding:0;border:0;outline:0;font-size:100%;vertical-align:baseline;background:transparent}body{line-height:1}ol,ul{list-style:none}blockquote,q{quotes:none}blockquote:before,blockquote:after,q:before,q:after{content:'';content:none}:focus{outline:0}ins{text-decoration:none}del{text-decoration:line-through}table{border-collapse:collapse;border-spacing:0}

data/website/stylesheets-vmail/site.css

@@ -0,0 +1,59 @@
+body {
+  -moz-background-clip:border;
+  -moz-background-inline-policy:continuous;
+  -moz-background-origin:padding;
+  border-top:5px solid #000000;
+  padding:20px 0;
+  font-family: Verdana, Arial, sans;
+  font-size: 14px;
+}
+#main {
+  padding-bottom: 40px;
+}
+hr {
+  margin-top: 28px;
+}
+p {
+}
+img.screenshot {
+  margin-bottom: 20px;
+  width: 260px; 
+}
+.sidebar {
+  width: 100%;
+  padding: 0 10px;
+}
+.sidebar h4 {
+  font-size: 16px;
+  margin-bottom: 0.75em;
+  clear:left;
+  margin-top: 1.25em;
+}
+.sidebar ul {
+  list-style: none;
+  margin-left: 0;
+}
+.sidebar ul li {
+  margin-left: 0;
+  font-weight: bold;
+}
+table.pin td {
+  vertical-align: top;
+  padding-bottom: 10px;
+}
+.red { color: red; font-weight:bold }
+.green {color:green; font-weight:bold}
+.purple {color:purple; font-weight:bold}
+.blue {color:blue; font-weight:bold}
+
+#main img {
+  width: 250px;
+}
+pre {
+  background-color: #ECECEC;
+}
+code {
+  background-color: #ECECEC;
+  font-size: 15px;
+}
+

data/website/stylesheets-vmail/syntax-colors.css

@@ -0,0 +1,33 @@
+pre {
+        background-color: #f1f1f3;
+        color: #112;
+        padding: 10px;
+        font-size: 13px;
+        overflow: auto;
+        margin: 4px 0px;
+		width: 97%;
+		overflow-x: auto;
+		overflow-y: hidden;
+		margin-top: 12px;
+}
+
+
+/* Syntax highlighting */
+pre .normal {}
+pre .comment { color: #005; font-style: italic; }
+pre .keyword { color: #A00; font-weight: bold; }
+pre .method { color: #077; }
+pre .class { color: #074; }
+pre .module { color: #050; }
+pre .punct { color: #447; font-weight: bold; }
+pre .symbol { color: #099; }
+pre .string { color: #944; background: #FFE; }
+pre .char { color: #F07; }
+pre .ident { color: #004; }
+pre .constant { color: #07F; }
+pre .regex { color: #B66; background: #FEF; }
+pre .number { color: #F99; }
+pre .attribute { color: #5bb; }
+pre .global { color: #7FB; }
+pre .expr { color: #227; }
+pre .escape { color: #277; }

data/website/stylesheets-vmail/text.css

@@ -0,0 +1 @@
+body{font:13px/1.5 'Helvetica Neue',Arial,'Liberation Sans',FreeSans,sans-serif}a:focus{outline:1px dotted}hr{border:0 #ccc solid;border-top-width:1px;clear:both;height:0}h1{font-size:25px}h2{font-size:23px}h3{font-size:21px}h4{font-size:19px}h5{font-size:17px}h6{font-size:15px}ol{list-style:decimal}ul{list-style:disc}li{margin-left:30px}p,dl,hr,h1,h2,h3,h4,h5,h6,ol,ul,pre,table,address,fieldset{margin-bottom:20px}

data/website/top.markdown

@@ -0,0 +1,9 @@
+# vmail
+
+vmail is a Vim interface to Gmail. Here are some screenshots:
+
+<a href="images-vmail/1.png" rel="lightbox[screens]"><img src="images-vmail/1-small.png" /></a>
+<a href="images-vmail/autocomplete.png" rel="lightbox[screens]"><img src="images-vmail/autocomplete-small.png" /></a>
+<a href="images-vmail/attach.png" rel="lightbox[screens]"><img src="images-vmail/attach-small.png" /></a>
+
+

data/website/vmail-template.html

@@ -0,0 +1,50 @@
+<!DOCTYPE html>
+<html lang="en">
+  <head>
+    <meta http-equiv="content-type" content="text/html; charset=utf-8" />
+      <title>Vmail</title>
+      <link href="stylesheets-vmail/reset.css?{{timestamp}}" media="screen" rel="stylesheet" type="text/css" />
+      <link href="stylesheets-vmail/960.css?{{timestamp}}" media="screen" rel="stylesheet" type="text/css" />
+      <link href="stylesheets-vmail/text.css?{{timestamp}}" media="screen" rel="stylesheet" type="text/css" />
+      <link href="stylesheets-vmail/site.css?{{timestamp}}" media="screen" rel="stylesheet" type="text/css" />
+      <script type="text/javascript" src="http://w.sharethis.com/button/buttons.js"></script><script type="text/javascript">stLight.options({publisher:'8579b5f8-0860-4ea6-9ef1-6f0f58359a99'});</script>
+      <script type="text/javascript" src="lightbox2/js/prototype.js"></script>
+      <script type="text/javascript" src="lightbox2/js/scriptaculous.js?load=effects,builder"></script>
+      <script type="text/javascript" src="lightbox2/js/lightbox.js"></script>
+      <link rel="stylesheet" href="lightbox2/css/lightbox.css" type="text/css" media="screen" />
+
+  </head>
+  <body>
+    <div class="container_12">
+      <div class="grid_10 alpha" id="main">
+        {{content}}
+      </div>
+      <div class="grid_2 omega">
+        
+          <div class="sidebar">
+
+            <h4>share this</h4>
+
+<span class="st_twitter_large" displayText="Tweet"></span><span class="st_facebook_large" displayText="Facebook"></span><span class="st_ybuzz_large" displayText="Yahoo! Buzz"></span><span class="st_gbuzz_large" displayText="Google Buzz"></span><span class="st_email_large" displayText="Email"></span><span class="st_sharethis_large" displayText="ShareThis"></span>
+
+            <h4>links</h4>
+            <ul>
+              <li><a href="https://github.com/danchoi/vmail">github repo</a></li>
+              <li><a href="https://rubygems.org/gems/vmail">rubygems page</a></li>
+            </ul>
+          </div>
+   
+      </div>
+    </div>
+
+<script type="text/javascript">
+var gaJsHost = (("https:" == document.location.protocol) ? "https://ssl." : "http://www.");
+document.write(unescape("%3Cscript src='" + gaJsHost + "google-analytics.com/ga.js' type='text/javascript'%3E%3C/script%3E"));
+</script>
+<script type="text/javascript">
+  var pageTracker = _gat._getTracker("UA-4028996-5");
+  pageTracker._initData();
+  pageTracker._trackPageview();
+</script>
+  </body>
+</html>

data/website/vmail.html

@@ -0,0 +1,438 @@
+<!DOCTYPE html>
+<html lang="en">
+  <head>
+    <meta http-equiv="content-type" content="text/html; charset=utf-8" />
+      <title>Vmail</title>
+      <link href="stylesheets-vmail/reset.css?1292349581" media="screen" rel="stylesheet" type="text/css" />
+      <link href="stylesheets-vmail/960.css?1292349581" media="screen" rel="stylesheet" type="text/css" />
+      <link href="stylesheets-vmail/text.css?1292349581" media="screen" rel="stylesheet" type="text/css" />
+      <link href="stylesheets-vmail/site.css?1292349581" media="screen" rel="stylesheet" type="text/css" />
+      <script type="text/javascript" src="http://w.sharethis.com/button/buttons.js"></script><script type="text/javascript">stLight.options({publisher:'8579b5f8-0860-4ea6-9ef1-6f0f58359a99'});</script>
+      <script type="text/javascript" src="lightbox2/js/prototype.js"></script>
+      <script type="text/javascript" src="lightbox2/js/scriptaculous.js?load=effects,builder"></script>
+      <script type="text/javascript" src="lightbox2/js/lightbox.js"></script>
+      <link rel="stylesheet" href="lightbox2/css/lightbox.css" type="text/css" media="screen" />
+
+  </head>
+  <body>
+    <div class="container_12">
+      <div class="grid_10 alpha" id="main">
+        <h1>vmail</h1>
+
+<p>vmail is a Vim interface to Gmail. Here are some screenshots:</p>
+
+<p><a href="images-vmail/1.png" rel="lightbox[screens]"><img src="images-vmail/1-small.png" /></a>
+<a href="images-vmail/autocomplete.png" rel="lightbox[screens]"><img src="images-vmail/autocomplete-small.png" /></a>
+<a href="images-vmail/attach.png" rel="lightbox[screens]"><img src="images-vmail/attach-small.png" /></a></p>
+
+
+<p>Why vmail? Because every minute you spend fumbling around in a web browser is a
+minute you're not experiencing the Zen of using a real text editor and staying
+close to the Unix command line.</p>
+
+<h2>Prerequisites</h2>
+
+<ul>
+<li>a Gmail account</li>
+<li>a relatively recent version of Vim (vmail is developed against Vim 7.3)</li>
+<li>Ruby (vmail is developed using Ruby 1.9.2)</li>
+<li>RubyGems (if Ruby version is older than 1.9)</li>
+<li>the <code>lynx</code> text-only-mode web browser is required to view HTML mail parts in vmail</li>
+</ul>
+
+
+<p>The current version of vmail assumes a Unix environment. I'll try to make later versions accommodate Windows.</p>
+
+<h2>Installation</h2>
+
+<pre><code>gem install vmail
+</code></pre>
+
+<h2>Configuration file</h2>
+
+<p>To run vmail, create a yaml file called <code>.vmailrc</code> and save it either in the
+current directory (the directory from which you launch vmail) or in your home
+directory.</p>
+
+<p>The <code>.vmailrc</code> file should look something like this. Substitute your own values.</p>
+
+<pre><code>username: dhchoi@gmail.com
+password: password
+name: Daniel Choi
+signature: |
+  --
+  Sent via vmail. http://danielchoi.com/software/vmail.html
+</code></pre>
+
+<p>This file should be formatted in <a href="https://github.com/danchoi/vmail">YAML syntax</a>.</p>
+
+<p>You can omit the password key-value pair if you'd rather not have the password
+saved in the file. In that case, you'll prompted for the password each time you
+start vmail.</p>
+
+<h2>Contacts autocompletion</h2>
+
+<p>vmail uses vim autocompletion to help you auto-complete email addresses.
+To use this feature, generate a <code>vmail-contacts.txt</code> file in the current or
+home directory. This is a simple list of your email contacts.
+Invoking vmail with the <code>-g</code> option generates this file for you by
+collecting all the recipients and cc's from your last 500 sent
+emails. You can adjust this number by using <code>-g</code> with a number argument.</p>
+
+<p>After vmail generates this file for you, you can edit it however and whenever
+you want, as long as there is one address per line.</p>
+
+<h2>Starting vmail</h2>
+
+<p>Once you've created the configuration file and (optionally) the contacts file,
+you can start vmail with</p>
+
+<pre><code>vmail
+</code></pre>
+
+<p>This opens the vmail/vim interface and shows you the last 100 messages in your
+Gmail inbox.</p>
+
+<p>You can have vmail show messages from any other mailbox (a.k.a. label) on
+startup by passing in the mailbox name as an argument:</p>
+
+<pre><code>vmail starred
+</code></pre>
+
+<p>You can also pass in search parameters:</p>
+
+<pre><code>vmail important from barackobama@whitehouse.gov
+</code></pre>
+
+<p>On startup, vmail loads 100 messages by default. You can increase or decrease
+this number by passing in a number after the mailbox name:</p>
+
+<pre><code>vmail inbox 700 subject unix
+</code></pre>
+
+<h2>Viewing messages</h2>
+
+<p>The first screen vmail shows you is a list of messages. You can view a message
+by moving the cursor line to it and pressing ENTER. This will split the screen
+and show the message content in the bottom pane.</p>
+
+<p>To full-screen the message, press SPACE when the cursor is the message window.
+To go back to the split view, press ENTER.</p>
+
+<p>You can full-screen the list window by pressing SPACE while the cursor is in it.</p>
+
+<p>In the split view, you can jump between the two panes by just pressing ENTER
+from either window.</p>
+
+<p>vmail loads a certain number messages at a time, starting with the most recent.
+If there are more messages that vmail hasn't loaded, you'll see a line at the
+top of the list that looks something like this:</p>
+
+<pre><code>&gt; Load 100 more messages. 156 remaining.
+</code></pre>
+
+<p>Put the cursor on this line and press ENTER to load more of these messages.</p>
+
+<p>Unread messages are marked with a <code>[+]</code> symbol.</p>
+
+<p>To view the raw RFC822 version of a message, type <code>,R</code> while viewing the message.</p>
+
+<h2>Starring, deleting, archiving, marking spam</h2>
+
+<p>To star a message, put the cursor on it and type <code>,*</code> or alternatively <code>s</code>.
+Starring a message copies it to the <code>starred</code> mailbox.  Starred messages are
+marked with a <code>[*]</code> symbol and color-highlighted.</p>
+
+<p>To delete a message, put the cursor on it and type <code>,#</code> or alternatively <code>,d</code>.
+Deleting a message puts it in the <code>trash</code> mailbox. Deleting a message from the
+<code>trash</code> mailbox deletes it permanently.</p>
+
+<p>To archive a message, put the cursor on it and type <code>,e</code>.  Archiving a message
+moves it to the <code>all</code> mailbox.</p>
+
+<p>To mark a message spam, put the cursor on it and type <code>,!</code>. This moves the
+message to to the <code>spam</code> mailbox.</p>
+
+<p>You can use range selections in the message list when you star, delete, mark as
+spam, or archive. Use <code>&lt;C-v&gt;</code> to start marking a range of lines (the vertical
+position of the cursor doesn't matter).  Then type any of the above commands to
+perform an action on all the messages you selected.</p>
+
+<h2>Switching mailboxes, moving messages, copying messages to another mailbox</h2>
+
+<p>To switch mailboxes, type <code>,m</code>. You'll see an autocomplete window appear at the top.
+The standard vim autocomplete keystrokes apply:</p>
+
+<ul>
+<li><code>C-p</code> and <code>C-n</code> move you up and down the match list</li>
+<li><code>C-e</code> closes the match list and lets you continue typing</li>
+<li><code>C-u</code>: 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.</li>
+<li><code>C-x C-u</code> finds matches for what you've typed so far (when the match list window is closed)</li>
+<li><code>C-y</code> selects the highlighted match without triggering ENTER</li>
+<li>ENTER selects the highlighted match from the match list</li>
+</ul>
+
+
+<p>Tip: start typing the first 1-3 characters of the mailbox name, then press
+<code>C-u</code> or <code>C-p</code> until you highlight the right match, and finally press ENTER to
+select.</p>
+
+<p>To move a message to another mailbox, put the cursor on the message in the
+message list, and type <code>,b</code>. You'll be prompted to select the target mailbox.</p>
+
+<p>To copy a message to another mailbox, put the cursor on the message in the
+message list, and type <code>,B</code>. You'll be prompted to select the target mailbox.</p>
+
+<h2>Composing messages</h2>
+
+<p>To start writing a new a email message, type <code>,c</code>.</p>
+
+<p>To reply to a message, type <code>,r</code>.</p>
+
+<p>To reply-all to a message, type <code>,a</code>.</p>
+
+<p>To forward a message, type <code>,f</code>.</p>
+
+<p>All these command open a message composition window. At the top, you will see
+mail headers like this:</p>
+
+<pre><code>from: Daniel Choi &lt;dhchoi@gmail.com&gt;
+to:
+subject:
+</code></pre>
+
+<p>The <code>from:</code> field will be pre-filled from your <code>.vmailrc</code> configuration.
+You're responsible for fill in the <code>to:</code> and the <code>subject:</code> fields.
+You can add a <code>cc:</code> and <code>bcc:</code> field if you want.</p>
+
+<p>When you fill in the recipient addresses, you can use vim autocompletion if you
+generated a <code>vmail-contacts.txt</code> file. Start typing a name or email address, then press <code>C-x C-u</code>
+to invoke autocompletion.</p>
+
+<p>Tip: Use <code>C-y</code> instead of ENTER to select a match. This will prevent you from
+creating a blank line in the middle of the email headers.</p>
+
+<p>Make sure your email addresses are separated by commas and that they all
+ultimately appear on the <strong>same, unbroken line</strong> for each field. Vim will
+probably break long lines automatically as you type them, so for now (pending a
+future enhancement), you'll have to rejoin the lines if breaks get inserted.</p>
+
+<p>After you fill in the headers, write your message.  Make sure there is a
+blank line between the headers and the body of your message.</p>
+
+<p>When you're done writing, send the message by typing <code>,vs</code> in normal mode.</p>
+
+<p>You can save the message as a draft in your draft mailbox by typing <code>,vd</code> in
+normal mode.</p>
+
+<p>At any point, you can quit the composition window by typing <code>q</code> in normal mode.</p>
+
+<h2>Attachments</h2>
+
+<p>The current version of vmail can handle attachments to a certain extent.</p>
+
+<p>When you're viewing a message with attachments, you'll see something like this
+at the top of the message window:</p>
+
+<pre><code>INBOX 2113 4 kb
+- image/png; name=canada.png
+- image/gif; name=arrow_right.gif
+---------------------------------------
+from: Daniel Choi &lt;dhchoi@gmail.com&gt;
+date: Sun, Dec 12 08:39 AM -05:00 2010
+to: Daniel Choi &lt;dhchoi@gmail.com&gt;
+subject: attachment test
+
+
+
+see attached
+</code></pre>
+
+<p>To download these attachments to a local directory, type <code>,A</code>. You'll be
+prompted for a directory path.  Then vmail will save all the attachments in the
+message to this directory.</p>
+
+<p>To send attachments, add something like this to your new message in the message
+composition window:</p>
+
+<pre><code>from: Daniel Choi &lt;dhchoi@gmail.com&gt;
+to: barackobama@whitehouse.gov
+subject: look at this!
+
+
+
+attach:
+- images/middle-east-map.png
+- images/policypaper.pdf
+- docs/
+
+
+
+I think you'll find this stuff interesting.
+</code></pre>
+
+<p>The <code>attach:</code> block is a YAML list. The items are paths (either relative or
+absolute) to the files you want to attach to your message. Note that you can
+also specify a directory, in which case vmail attaches every file it finds in
+that directory.</p>
+
+<p>One thing vmail doesn't do yet is let you forward a message with all its
+attachments intact.  This feature will be implemented in the near future.</p>
+
+<h2>Printing messages to a file</h2>
+
+<p><code>,vp</code> from the message list prints (appends) the text content of all the selected
+messages to a file.</p>
+
+<h2>Invoking your web browser</h2>
+
+<p>When you're reading a message, <code>,o</code> opens the first hyperlink in the document
+on or after the cursor in your normal web browser.</p>
+
+<p>When you're reading a message with an html mail part, <code>,h</code> saves that part to a
+local file (<code>vmail-htmlpart.html</code>) and opens it in your normal web browser.</p>
+
+<p>By default, the command vmail uses to open your web browser is <code>open</code>. In OS X,
+this opens URLs and HTML files in the default web browser.  You can change the
+browser vmail invokes by setting the VMAIL_BROWSER environmental variable
+before you start vmail, e.g.:</p>
+
+<pre><code>export VMAIL_BROWSER='elinks'
+</code></pre>
+
+<h2>Search queries</h2>
+
+<p>vmail can generate a message list by performing an IMAP search on the current mailbox.
+From the message list window, type <code>,s</code>. This will prompt you for a search query.
+The search query is an optional number specifying the number of messages to return,
+followed by a valid IMAP search query.</p>
+
+<p>Here are some example search queries.</p>
+
+<pre><code># the default 
+100 all  
+
+
+
+# all messages from thematrix.com domain
+from thematrix.com  
+
+
+
+# all messages from this person
+from barackobama@whitehouse.gov  
+
+
+
+# subject field search; use double quotes to enclose multiple words
+subject "unix philosophy"  
+
+
+
+# example of date range and multiple conditions
+before 30-Nov-2010 since 1-Nov-2010 from prx.org  
+</code></pre>
+
+<p>Tip: When you're entering your search query, <code>&lt;C-u&gt;</code> clears the query line.</p>
+
+<p>Power-Tip: <code>&lt;C-f&gt;</code> 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.</p>
+
+<h2>Using vmail with MacVim</h2>
+
+<p>vmail uses standard Vim by default, but vmail also works with MacVim, but not
+perfectly. In particular, there seems to be a bug in MacVim that prevents
+vmail's status line activity messages from appearing properly. Nonetheless,
+most of vmail is functional in MacVim.</p>
+
+<p>To use MacVim as your vmail Vim engine, <code>export VMAIL_VIM=mvim</code> before startin
+vmail.</p>
+
+<p>Note that when vmail uses MacVim, the terminal window in which you invoke vmail
+will show vmail's logging output while MacVim is running. To quit vmail in
+MacVim mode, you will have to press CTRL-c in this window to stop the vmail
+process.</p>
+
+<h2>vmail file byproducts</h2>
+
+<p>vmail generates a few file byproducts when it is running. It generates a
+temporary <code>vmailbuffer.txt</code> file in the current directory to hold the message
+list. This should get deleted automatically when vmail quits.</p>
+
+<p>vmail also creates a <code>vmail-htmlpart.html</code> file in the current directory if you
+open an HTML mail part from vmail.</p>
+
+<p>Finally, vmail logs output to a <code>vmail.log</code> file which it creates in the
+current directory. You can tail this file in a separate terminal window to see
+what's going on behind the scenes as you use vmail.</p>
+
+<h2>Is my gmail password secure?</h2>
+
+<p>In short, yes. vmail uses TLS (<a href="https://github.com/danchoi/vmail">Transport Layer Security</a>) to perform IMAP
+and SMTP authentication. So vmail transmits your password securely over the
+network.</p>
+
+<p>You can also be sure that the vmail code doesn't do anything nefarious with your
+Gmail password because vmail is open source. Anyone can inspect the source code
+of the copy fo vmail that runs on your computer and inspect the code at the
+<a href="https://github.com/danchoi/vmail">github repository</a> and at <a href="https://rubygems.org/gems/vmail">rubygems.org</a> (where the vmail gem is
+downloaded from).</p>
+
+<h2>Bug reports, feature requests</h2>
+
+<p>Please file bug reports and features requests in the <a href="https://github.com/danchoi/vmail">vmail github issue tracker</a>.</p>
+
+<h2>How to contact the developer</h2>
+
+<p>My name is Daniel Choi. I am based in Cambridge, MA, and you can email me at dhchoi@gmail.com.</p>
+
+
+<h2>How to support the vmail project</h2>
+
+<p>If you find vmail very useful, feel free to drop me a note to say so. If you have
+a bug to report or a good feature to suggest, please file it on the <a href="https://github.com/danchoi/vmail/issues">issue tracker</a>.
+Few things make this software developer happier than knowing that people find my
+software useful.</p>
+
+<p>Please do not feel obligated to donate money simply because you use vmail. But if you
+want to donate some money to support the independent software developer behind
+vmail, use this PayPal button:</p>
+
+<p><form action="https://www.paypal.com/cgi-bin/webscr" method="post">
+<input type="hidden" name="cmd" value="_s-xclick">
+<input type="hidden" name="hosted_button_id" value="YC3S3D5RFMJSC">
+<input type="image" src="https://www.paypal.com/en_US/i/btn/btn_donateCC_LG.gif" border="0" name="submit" alt="PayPal - The safer, easier way to pay online!">
+<img alt="" border="0" src="https://www.paypal.com/en_US/i/scr/pixel.gif" width="1" height="1">
+</form></p>
+
+      </div>
+      <div class="grid_2 omega">
+        
+          <div class="sidebar">
+
+            <h4>share this</h4>
+
+<span class="st_twitter_large" displayText="Tweet"></span><span class="st_facebook_large" displayText="Facebook"></span><span class="st_ybuzz_large" displayText="Yahoo! Buzz"></span><span class="st_gbuzz_large" displayText="Google Buzz"></span><span class="st_email_large" displayText="Email"></span><span class="st_sharethis_large" displayText="ShareThis"></span>
+
+            <h4>links</h4>
+            <ul>
+              <li><a href="https://github.com/danchoi/vmail">github repo</a></li>
+              <li><a href="https://rubygems.org/gems/vmail">rubygems page</a></li>
+            </ul>
+          </div>
+   
+      </div>
+    </div>
+
+<script type="text/javascript">
+var gaJsHost = (("https:" == document.location.protocol) ? "https://ssl." : "http://www.");
+document.write(unescape("%3Cscript src='" + gaJsHost + "google-analytics.com/ga.js' type='text/javascript'%3E%3C/script%3E"));
+</script>
+<script type="text/javascript">
+  var pageTracker = _gat._getTracker("UA-4028996-5");
+  pageTracker._initData();
+  pageTracker._trackPageview();
+</script>
+  </body>
+</html>