d9/2567a69273b09e24b85e352d9610bbaa95c7d1

   1 Return-Path: <jani@nikula.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 2E75F431FBD\r
   6         for <notmuch@notmuchmail.org>; Sun,  9 Mar 2014 23:26:18 -0700 (PDT)\r
   7 X-Virus-Scanned: Debian amavisd-new at olra.theworths.org\r
   8 X-Spam-Flag: NO\r
   9 X-Spam-Score: -0.7\r
  10 X-Spam-Level: \r
  11 X-Spam-Status: No, score=-0.7 tagged_above=-999 required=5\r
  12         tests=[RCVD_IN_DNSWL_LOW=-0.7] 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 AQZ7XaHhexDx for <notmuch@notmuchmail.org>;\r
  16         Sun,  9 Mar 2014 23:26:13 -0700 (PDT)\r
  17 Received: from mail-ee0-f51.google.com (mail-ee0-f51.google.com\r
  18  [74.125.83.51])        (using TLSv1 with cipher RC4-SHA (128/128 bits))        (No client\r
  19  certificate requested) by olra.theworths.org (Postfix) with ESMTPS id\r
  20  8A8C5431FC9    for <notmuch@notmuchmail.org>; Sun,  9 Mar 2014 23:26:12 -0700\r
  21  (PDT)\r
  22 Received: by mail-ee0-f51.google.com with SMTP id c13so2907288eek.10\r
  23         for <notmuch@notmuchmail.org>; Sun, 09 Mar 2014 23:26:11 -0700 (PDT)\r
  24 X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;\r
  25         d=1e100.net; s=20130820;\r
  26         h=x-gm-message-state:from:to:cc:subject:date:message-id:in-reply-to\r
  27         :references;\r
  28         bh=T4t+/I1zyqzpp608dQ2YY/2JN5EFru+jb6cUl/RqNn0=;\r
  29         b=bla/p6SXldDD/fyqfVPI/jZDn42cvLixxIa5YPy3IBVcPGtwX9JyBV/HMh6WBBlcyu\r
  30         ZQuVuqBw5pnzgcqAy1LTQQ5BIs9CqawFxoTi2RgJQixWq+db2Nb9xtTQGHuAEumEbKZg\r
  31         YfglpsO6/NZRLvOF4TTJ9oRajJBn7HZqF3szJS+LAGyZ6S9w9h8MoMkdBi/QTCMETq55\r
  32         zF9JKLzXMiUxkknCgfHnGxKBaJxRepUsXtnwtvmEvCl/PhSnNr4zhboZQ7mSj7VmDuNV\r
  33         xgljfu4AlOLNfOEHVy2u9Q8nzMA26bTfsC4nExDksVa5+I3usByX+a/qIiQDrXvf57uO\r
  34         7bpg==\r
  35 X-Gm-Message-State:\r
  36  ALoCoQkgbeExW4P2KZf2rUVbtvDHAMTMEeI3aOXjoUgIxQIEcUMaIgg26y6E1vRg39EqT9YlZxQN\r
  37 X-Received: by 10.15.35.66 with SMTP id f42mr1151670eev.93.1394432771308;\r
  38         Sun, 09 Mar 2014 23:26:11 -0700 (PDT)\r
  39 Received: from localhost (dsl-hkibrasgw2-58c36f-91.dhcp.inet.fi.\r
  40         [88.195.111.91])\r
  41         by mx.google.com with ESMTPSA id w6sm41233609eex.9.2014.03.09.23.26.10\r
  42         for <multiple recipients>\r
  43         (version=TLSv1.2 cipher=RC4-SHA bits=128/128);\r
  44         Sun, 09 Mar 2014 23:26:10 -0700 (PDT)\r
  45 From: Jani Nikula <jani@nikula.org>\r
  46 To: notmuch@notmuchmail.org\r
  47 Subject: [PATCH v5] man: try to clarify the folder: and path: vs.\r
  48         --output=files confusion\r
  49 Date: Mon, 10 Mar 2014 08:26:09 +0200\r
  50 Message-Id: <1394432769-3518-1-git-send-email-jani@nikula.org>\r
  51 X-Mailer: git-send-email 1.9.0\r
  52 In-Reply-To:\r
  53  <108f8bb2ea61552c84c342af81bf312df308f619.1394400503.git.jani@nikula.org>\r
  54 References:\r
  55  <108f8bb2ea61552c84c342af81bf312df308f619.1394400503.git.jani@nikula.org>\r
  56 X-BeenThere: notmuch@notmuchmail.org\r
  57 X-Mailman-Version: 2.1.13\r
  58 Precedence: list\r
  59 List-Id: "Use and development of the notmuch mail system."\r
  60         <notmuch.notmuchmail.org>\r
  61 List-Unsubscribe: <http://notmuchmail.org/mailman/options/notmuch>,\r
  62         <mailto:notmuch-request@notmuchmail.org?subject=unsubscribe>\r
  63 List-Archive: <http://notmuchmail.org/pipermail/notmuch>\r
  64 List-Post: <mailto:notmuch@notmuchmail.org>\r
  65 List-Help: <mailto:notmuch-request@notmuchmail.org?subject=help>\r
  66 List-Subscribe: <http://notmuchmail.org/mailman/listinfo/notmuch>,\r
  67         <mailto:notmuch-request@notmuchmail.org?subject=subscribe>\r
  68 X-List-Received-Date: Mon, 10 Mar 2014 06:26:18 -0000\r
  69 \r
  70 ---\r
  71  doc/man1/notmuch-search.rst | 9 +++++++--\r
  72  1 file changed, 7 insertions(+), 2 deletions(-)\r
  73 \r
  74 diff --git a/doc/man1/notmuch-search.rst b/doc/man1/notmuch-search.rst\r
  75 index 7ac6c68e68ac..90160f21e23c 100644\r
  76 --- a/doc/man1/notmuch-search.rst\r
  77 +++ b/doc/man1/notmuch-search.rst\r
  78 @@ -64,8 +64,13 @@ Supported options for **search** include\r
  79              (--format=json), or as an S-Expression list (--format=sexp).\r
  80  \r
  81              Note that each message may have multiple filenames\r
  82 -            associated with it. All of them are included in the output,\r
  83 -            unless limited with the --duplicate=N option.\r
  84 +            associated with it. All of them are included in the output\r
  85 +            (unless limited with the --duplicate=N option). This may\r
  86 +            be particularly confusing for **folder:** or **path:**\r
  87 +            searches in a specified directory, as the messages may\r
  88 +            have duplicates in other directories that are included in\r
  89 +            the output, although these files alone would not match the\r
  90 +            search.\r
  91  \r
  92          **tags**\r
  93              Output all tags that appear on any message matching the\r
  94 -- \r
  95 1.9.0\r
  96 \r