5a/855939a79bc1963c15365cb44582a8c95ef1f8

   1 Return-Path: <bremner@tethera.net>\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 1A550429E35\r
   6         for <notmuch@notmuchmail.org>; Sat,  8 Mar 2014 13:21:26 -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: 0\r
  10 X-Spam-Level: \r
  11 X-Spam-Status: No, score=0 tagged_above=-999 required=5 tests=[none]\r
  12         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 8t4PW3+fg3bb for <notmuch@notmuchmail.org>;\r
  16         Sat,  8 Mar 2014 13:21:20 -0800 (PST)\r
  17 Received: from yantan.tethera.net (yantan.tethera.net [199.188.72.155])\r
  18         (using TLSv1 with cipher DHE-RSA-AES128-SHA (128/128 bits))\r
  19         (No client certificate requested)\r
  20         by olra.theworths.org (Postfix) with ESMTPS id 570E3431FC0\r
  21         for <notmuch@notmuchmail.org>; Sat,  8 Mar 2014 13:20:44 -0800 (PST)\r
  22 Received: from remotemail by yantan.tethera.net with local (Exim 4.80)\r
  23         (envelope-from <bremner@tethera.net>)\r
  24         id 1WMOfj-00059W-Px; Sat, 08 Mar 2014 17:20:43 -0400\r
  25 Received: (nullmailer pid 28546 invoked by uid 1000); Sat, 08 Mar 2014\r
  26         21:20:03 -0000\r
  27 From: David Bremner <david@tethera.net>\r
  28 To: notmuch@notmuchmail.org\r
  29 Subject: [Patch v3 10/15] man: update man pages for folder: and path: search\r
  30         terms\r
  31 Date: Sat,  8 Mar 2014 17:19:40 -0400\r
  32 Message-Id: <1394313585-28422-11-git-send-email-david@tethera.net>\r
  33 X-Mailer: git-send-email 1.8.5.3\r
  34 In-Reply-To: <1394313585-28422-1-git-send-email-david@tethera.net>\r
  35 References: <1394313585-28422-1-git-send-email-david@tethera.net>\r
  36 X-BeenThere: notmuch@notmuchmail.org\r
  37 X-Mailman-Version: 2.1.13\r
  38 Precedence: list\r
  39 List-Id: "Use and development of the notmuch mail system."\r
  40         <notmuch.notmuchmail.org>\r
  41 List-Unsubscribe: <http://notmuchmail.org/mailman/options/notmuch>,\r
  42         <mailto:notmuch-request@notmuchmail.org?subject=unsubscribe>\r
  43 List-Archive: <http://notmuchmail.org/pipermail/notmuch>\r
  44 List-Post: <mailto:notmuch@notmuchmail.org>\r
  45 List-Help: <mailto:notmuch-request@notmuchmail.org?subject=help>\r
  46 List-Subscribe: <http://notmuchmail.org/mailman/listinfo/notmuch>,\r
  47         <mailto:notmuch-request@notmuchmail.org?subject=subscribe>\r
  48 X-List-Received-Date: Sat, 08 Mar 2014 21:21:26 -0000\r
  49 \r
  50 From: Jani Nikula <jani@nikula.org>\r
  51 \r
  52 ---\r
  53  man/man7/notmuch-search-terms.7 | 28 ++++++++++++++++++++++------\r
  54  1 file changed, 22 insertions(+), 6 deletions(-)\r
  55 \r
  56 diff --git a/man/man7/notmuch-search-terms.7 b/man/man7/notmuch-search-terms.7\r
  57 index a768b63..907403d 100644\r
  58 --- a/man/man7/notmuch-search-terms.7\r
  59 +++ b/man/man7/notmuch-search-terms.7\r
  60 @@ -54,6 +54,8 @@ terms to match against specific portions of an email, (where\r
  61  \r
  62         folder:<directory-path>\r
  63  \r
  64 +       path:<directory-path> or path:<directory-path>/**\r
  65 +\r
  66         date:<since>..<until>\r
  67  \r
  68  The\r
  69 @@ -101,12 +103,26 @@ thread ID values can be seen in the first column of output from\r
  70  \r
  71  The\r
  72  .B folder:\r
  73 -prefix can be used to search for email message files that are\r
  74 -contained within particular directories within the mail store. If the\r
  75 -same email message has multiple message files associated with it, it's\r
  76 -sufficient for a match that at least one of the files is contained\r
  77 -within a matching directory. Only the directory components below the\r
  78 -top-level mail database path are available to be searched.\r
  79 +and\r
  80 +.B path:\r
  81 +prefixes can be used to search for email message files that are\r
  82 +contained within particular directories within the mail store. The\r
  83 +directories are specified relative from the top-level mail database\r
  84 +path, and thus only the directory components below that are available\r
  85 +to be searched.\r
  86 +\r
  87 +The\r
  88 +.B folder:\r
  89 +prefix matches messages in the specified maildir folder, i.e. in the\r
  90 +specified directory and its "new" and "cur" subdirectories. The\r
  91 +.B path:\r
  92 +prefix matches messages in the specified directory only, unless the\r
  93 +"/**" suffix is used to denote the specified directory and all its\r
  94 +subdirectories recursively. For both, the empty string "" matches the\r
  95 +top level maildir folder or directory. If the same email message has\r
  96 +multiple message files associated with it, it's sufficient for a match\r
  97 +that at least one of the files is contained within a matching\r
  98 +directory.\r
  99  \r
 100  The\r
 101  .B date:\r
 102 -- \r
 103 1.8.5.3\r
 104 \r