9e/84eeb3c3e5fdf5a09a0c6ecba2c82a8babec75

   1 Return-Path: <cworth@cworth.org>\r
   2 X-Original-To: notmuch@notmuchmail.org\r
   3 Delivered-To: notmuch@notmuchmail.org\r
   4 Received: from localhost (localhost [127.0.0.1])\r
   5         by olra.theworths.org (Postfix) with ESMTP id 17A8142D287\r
   6         for <notmuch@notmuchmail.org>; Sat, 15 Jan 2011 14:46:58 -0800 (PST)\r
   7 X-Virus-Scanned: Debian amavisd-new at olra.theworths.org\r
   8 X-Spam-Flag: NO\r
   9 X-Spam-Score: -1\r
  10 X-Spam-Level: \r
  11 X-Spam-Status: No, score=-1 tagged_above=-999 required=5\r
  12         tests=[ALL_TRUSTED=-1] autolearn=disabled\r
  13 Received: from olra.theworths.org ([127.0.0.1])\r
  14         by localhost (olra.theworths.org [127.0.0.1]) (amavisd-new, port 10024)\r
  15         with ESMTP id ctkt6oka8huJ for <notmuch@notmuchmail.org>;\r
  16         Sat, 15 Jan 2011 14:46:57 -0800 (PST)\r
  17 Received: from yoom.home.cworth.org (localhost [127.0.0.1])\r
  18         by olra.theworths.org (Postfix) with ESMTP id 4E1B442D286\r
  19         for <notmuch@notmuchmail.org>; Sat, 15 Jan 2011 14:46:55 -0800 (PST)\r
  20 Received: by yoom.home.cworth.org (Postfix, from userid 1000)\r
  21         id 987F6254007; Sat, 15 Jan 2011 14:46:53 -0800 (PST)\r
  22 From: Carl Worth <cworth@cworth.org>\r
  23 To: notmuch@notmuchmail.org\r
  24 Subject: Folder-based searching\r
  25 User-Agent: Notmuch/0.5 (http://notmuchmail.org) Emacs/23.2.1\r
  26         (i486-pc-linux-gnu)\r
  27 Date: Sat, 15 Jan 2011 14:46:53 -0800\r
  28 Message-ID: <87tyh9wzs2.fsf@yoom.home.cworth.org>\r
  29 MIME-Version: 1.0\r
  30 Content-Type: text/plain; charset=us-ascii\r
  31 X-BeenThere: notmuch@notmuchmail.org\r
  32 X-Mailman-Version: 2.1.13\r
  33 Precedence: list\r
  34 List-Id: "Use and development of the notmuch mail system."\r
  35         <notmuch.notmuchmail.org>\r
  36 List-Unsubscribe: <http://notmuchmail.org/mailman/options/notmuch>,\r
  37         <mailto:notmuch-request@notmuchmail.org?subject=unsubscribe>\r
  38 List-Archive: <http://notmuchmail.org/pipermail/notmuch>\r
  39 List-Post: <mailto:notmuch@notmuchmail.org>\r
  40 List-Help: <mailto:notmuch-request@notmuchmail.org?subject=help>\r
  41 List-Subscribe: <http://notmuchmail.org/mailman/listinfo/notmuch>,\r
  42         <mailto:notmuch-request@notmuchmail.org?subject=subscribe>\r
  43 X-List-Received-Date: Sat, 15 Jan 2011 22:46:58 -0000\r
  44 \r
  45 I'm as sad as anyone to see that I let more than a month go by without\r
  46 committing to the notmuch repository.\r
  47 \r
  48 But I've just now committed the much-desired folder-based search\r
  49 feature.\r
  50 \r
  51 This should be a handy feature for people bringing mail in from a system\r
  52 that stores information in the directories in which mail is stored, (one\r
  53 common case is users fetching mail from gmail via imap---in this case\r
  54 all gmail tags will be represented as directories).\r
  55 \r
  56 Someone bringing in mail from such a system might want to migrate from\r
  57 information in directory names to instead be information in notmuch\r
  58 tags. That might look something like this:\r
  59 \r
  60         notmuch tag +important folder:important\r
  61 \r
  62 Or it might be useful to run on several directories:\r
  63 \r
  64         for dir in *; do notmuch tag +"$dir"; folder:"$dir"; done\r
  65 \r
  66 etc.\r
  67 \r
  68 Please note that with the code in git currently, only newly incorporated\r
  69 mail will be searchable via the "folder:" specification. So if you're\r
  70 wanting to search your entire email collection, you may want to rebuild\r
  71 your entire notmuch database. As a reminder, that process is something\r
  72 like the following:\r
  73 \r
  74     notmuch dump > notmuch.dump\r
  75     rm -rf ~/mail/.notmuch      # Careful with this! Have backups in place!\r
  76     notmuch new                 # Of course, this can take a long time\r
  77     notmuch restore notmuch.dump\r
  78 \r
  79 Before the next release, I plan to increment the database version so\r
  80 that users will be notified of the need to do an upgrade like this. (But\r
  81 before I do that, I plan to implement a few more database changes---and\r
  82 some of them are likely to be much more invasive than this one).\r
  83 \r
  84 Have fun out there!\r
  85 \r
  86 -Carl\r