ANNOUNCE: nottoomuch-addresses.sh 2.2
authorTomi Ollila <tomi.ollila@iki.fi>
Sat, 29 Mar 2014 16:07:43 +0000 (18:07 +0200)
committerW. Trevor King <wking@tremily.us>
Fri, 7 Nov 2014 18:01:03 +0000 (10:01 -0800)
b7/5ad1bcecab50e80246224d3fb0ee6a60950907 [new file with mode: 0644]

diff --git a/b7/5ad1bcecab50e80246224d3fb0ee6a60950907 b/b7/5ad1bcecab50e80246224d3fb0ee6a60950907
new file mode 100644 (file)
index 0000000..7c0fbe6
--- /dev/null
@@ -0,0 +1,133 @@
+Return-Path: <tomi.ollila@iki.fi>\r
+X-Original-To: notmuch@notmuchmail.org\r
+Delivered-To: notmuch@notmuchmail.org\r
+Received: from localhost (localhost [127.0.0.1])\r
+       by olra.theworths.org (Postfix) with ESMTP id 3B642431FBD\r
+       for <notmuch@notmuchmail.org>; Sat, 29 Mar 2014 09:07:57 -0700 (PDT)\r
+X-Virus-Scanned: Debian amavisd-new at olra.theworths.org\r
+X-Spam-Flag: NO\r
+X-Spam-Score: 0\r
+X-Spam-Level: \r
+X-Spam-Status: No, score=0 tagged_above=-999 required=5 tests=[none]\r
+       autolearn=disabled\r
+Received: from olra.theworths.org ([127.0.0.1])\r
+       by localhost (olra.theworths.org [127.0.0.1]) (amavisd-new, port 10024)\r
+       with ESMTP id ilE34U8z2mlu for <notmuch@notmuchmail.org>;\r
+       Sat, 29 Mar 2014 09:07:51 -0700 (PDT)\r
+Received: from guru.guru-group.fi (guru.guru-group.fi [46.183.73.34])\r
+       by olra.theworths.org (Postfix) with ESMTP id 9CD71431FBC\r
+       for <notmuch@notmuchmail.org>; Sat, 29 Mar 2014 09:07:51 -0700 (PDT)\r
+Received: from guru.guru-group.fi (localhost [IPv6:::1])\r
+       by guru.guru-group.fi (Postfix) with ESMTP id 71DFA1000E5\r
+       for <notmuch@notmuchmail.org>; Sat, 29 Mar 2014 18:07:43 +0200 (EET)\r
+From: Tomi Ollila <tomi.ollila@iki.fi>\r
+To: notmuch@notmuchmail.org\r
+Subject: ANNOUNCE: nottoomuch-addresses.sh 2.2\r
+In-Reply-To: <m2d3c8e22v.fsf@guru.guru-group.fi>\r
+References: <m2d3c8e22v.fsf@guru.guru-group.fi>\r
+User-Agent: Notmuch/0.17+171~g9a127b7 (http://notmuchmail.org) Emacs/24.3.1\r
+       (x86_64-unknown-linux-gnu)\r
+X-Face: HhBM'cA~<r"^Xv\KRN0P{vn'Y"Kd;zg_y3S[4)KSN~s?O\"QPoL\r
+       $[Xv_BD:i/F$WiEWax}R(MPS`^UaptOGD`*/=@\1lKoVa9tnrg0TW?"r7aRtgk[F\r
+       !)g;OY^,BjTbr)Np:%c_o'jj,Z\r
+Date: Sat, 29 Mar 2014 18:07:43 +0200\r
+Message-ID: <m2ha6hvvhs.fsf@guru.guru-group.fi>\r
+MIME-Version: 1.0\r
+Content-Type: text/plain\r
+X-BeenThere: notmuch@notmuchmail.org\r
+X-Mailman-Version: 2.1.13\r
+Precedence: list\r
+List-Id: "Use and development of the notmuch mail system."\r
+       <notmuch.notmuchmail.org>\r
+List-Unsubscribe: <http://notmuchmail.org/mailman/options/notmuch>,\r
+       <mailto:notmuch-request@notmuchmail.org?subject=unsubscribe>\r
+List-Archive: <http://notmuchmail.org/pipermail/notmuch>\r
+List-Post: <mailto:notmuch@notmuchmail.org>\r
+List-Help: <mailto:notmuch-request@notmuchmail.org?subject=help>\r
+List-Subscribe: <http://notmuchmail.org/mailman/listinfo/notmuch>,\r
+       <mailto:notmuch-request@notmuchmail.org?subject=subscribe>\r
+X-List-Received-Date: Sat, 29 Mar 2014 16:07:57 -0000\r
+\r
+Hi all\r
+\r
+Here is a new version of nottoomuch-addresses.sh, after a while of\r
+dogfooding...\r
+\r
+nottoomuch-addresses.sh\r
+=======================\r
+\r
+*Nottoomuch-addresses.sh* is an email address completion/matching tool\r
+to be used with `notmuch <http://notmuchmail.org>`_ mail user agents.\r
+\r
+*Nottoomuch-addresses.sh* works by caching the email addresses from users'\r
+email files and then doing (fgrep) matching against that cache when\r
+requested.\r
+\r
+The matching part is very fast.\r
+\r
+above from:\r
+https://github.com/domo141/nottoomuch/blob/master/nottoomuch-addresses.rst\r
+\r
+\r
+For those who have been using version 2.1, the changes are:\r
+\r
+# Version 2.2  2014-03-29 15:12:14 UTC\r
+#   * In case there is both {phrase} and (comment) in an email address,\r
+#     append comment to the phrase. This will make more duplicates to be\r
+#     removed. Now there can be:\r
+#       <user@host>\r
+#       "phrase" <user@host>\r
+#       "phrase (comment)" <user@host>\r
+#       <user@host> (comment)\r
+#   * In case email address is in form "someuser@somehost" <someuser@somehost>\r
+#     i.e. the phrase is exactly the same as <address>, phrase is dropped.\r
+\r
+\r
+I planned to do some more combining of emails, but it proved to be a bit\r
+more challenging that I thought of. The Bar, Foo -> Foo Bar conversion\r
+looks like an interesting thing to do next which I will investigate in \r
+future...\r
+\r
+The new version is available at\r
+\r
+https://raw.githubusercontent.com/domo141/nottoomuch/master/nottoomuch-addresses.sh\r
+\r
+or git clone https://github.com:domo141/nottoomuch.git\r
+and then by picking nottoomuch-addresses.sh from there.\r
+\r
+\r
+How to install (also written in that nottoomuch-addresses.rst link above):\r
+\r
+1) Download the program from above url on the machine you're running\r
+   notmuch and find suitable location to it.\r
+\r
+2) Verify it's sha1 checksum is 3855dd7b07490c0440deb7984633893b1847879d\r
+\r
+3) chmod 755 /path/to/nottoomuch-addresses.sh\r
+\r
+4) Run  /path/to/nottoomuch-addresses.sh --update\r
+   When run first time this gathers email addresses from all of your mail.\r
+   This may take a long while to complete -- depends on the amount of email\r
+   you have. Further --updates are much faster as those just take addresses\r
+   from new mail.\r
+\r
+5) Test that it works: Run  /path/to/nottoomuch-addresses.sh notmuchmail\r
+\r
+6) In case you're using emacs mua with notmuch, edit your notmuch\r
+   configuration for emacs with the following content:\r
+\r
+   (require 'notmuch-address)\r
+   (setq notmuch-address-command "/path/to/nottoomuch-addresses.sh")\r
+   (notmuch-address-message-insinuate)\r
+\r
+7) Restart emacs notmuch mua (or eval above lines) and start composing\r
+   new mail. When adding recipient to To: field. press <TAB> after 3\r
+   or more characters have been added. In case you get 2 or more address\r
+   matches, use arrow keys in minibuffer to choose desired recipient...\r
+\r
+8) Enjoy!\r
+\r
+/path/to/nottoomuch-addresses.sh --help  provides more detailed information.\r
+\r
+BR,\r
+Tomi\r