67/a37a03e928c2eb965945db1bc69425d8c8d8cf

   1 Return-Path: <dkg@fifthhorseman.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 arlo.cworth.org (Postfix) with ESMTP id 96BC16DE01D0\r
   6  for <notmuch@notmuchmail.org>; Thu,  2 Jun 2016 09:01:38 -0700 (PDT)\r
   7 X-Virus-Scanned: Debian amavisd-new at cworth.org\r
   8 X-Spam-Flag: NO\r
   9 X-Spam-Score: -0.022\r
  10 X-Spam-Level: \r
  11 X-Spam-Status: No, score=-0.022 tagged_above=-999 required=5\r
  12  tests=[AWL=-0.022] autolearn=disabled\r
  13 Received: from arlo.cworth.org ([127.0.0.1])\r
  14  by localhost (arlo.cworth.org [127.0.0.1]) (amavisd-new, port 10024)\r
  15  with ESMTP id ExnO7gTS4TWq for <notmuch@notmuchmail.org>;\r
  16  Thu,  2 Jun 2016 09:01:29 -0700 (PDT)\r
  17 Received: from che.mayfirst.org (che.mayfirst.org [162.247.75.118])\r
  18  by arlo.cworth.org (Postfix) with ESMTP id BF3906DE00DB\r
  19  for <notmuch@notmuchmail.org>; Thu,  2 Jun 2016 09:01:29 -0700 (PDT)\r
  20 Received: from fifthhorseman.net (unknown [38.109.115.130])\r
  21  by che.mayfirst.org (Postfix) with ESMTPSA id 7BAD1F98B\r
  22  for <notmuch@notmuchmail.org>; Thu,  2 Jun 2016 12:01:28 -0400 (EDT)\r
  23 Received: by fifthhorseman.net (Postfix, from userid 1000)\r
  24  id 381BB20245; Thu,  2 Jun 2016 12:01:28 -0400 (EDT)\r
  25 From: Daniel Kahn Gillmor <dkg@fifthhorseman.net>\r
  26 To: Notmuch Mail <notmuch@notmuchmail.org>\r
  27 Subject: [PATCH 1/2] doc: clean up boolean vs. probabilistic prefixes\r
  28 Date: Thu,  2 Jun 2016 12:01:27 -0400\r
  29 Message-Id: <1464883288-19823-1-git-send-email-dkg@fifthhorseman.net>\r
  30 X-Mailer: git-send-email 2.8.1\r
  31 MIME-Version: 1.0\r
  32 Content-Type: text/plain; charset=UTF-8\r
  33 Content-Transfer-Encoding: 8bit\r
  34 X-BeenThere: notmuch@notmuchmail.org\r
  35 X-Mailman-Version: 2.1.20\r
  36 Precedence: list\r
  37 List-Id: "Use and development of the notmuch mail system."\r
  38  <notmuch.notmuchmail.org>\r
  39 List-Unsubscribe: <https://notmuchmail.org/mailman/options/notmuch>,\r
  40  <mailto:notmuch-request@notmuchmail.org?subject=unsubscribe>\r
  41 List-Archive: <http://notmuchmail.org/pipermail/notmuch/>\r
  42 List-Post: <mailto:notmuch@notmuchmail.org>\r
  43 List-Help: <mailto:notmuch-request@notmuchmail.org?subject=help>\r
  44 List-Subscribe: <https://notmuchmail.org/mailman/listinfo/notmuch>,\r
  45  <mailto:notmuch-request@notmuchmail.org?subject=subscribe>\r
  46 X-List-Received-Date: Thu, 02 Jun 2016 16:01:38 -0000\r
  47 \r
  48 sphinx-build emits a minor warning:\r
  49 \r
  50 [...]doc/man7/notmuch-search-terms.rst:223: WARNING: Block quote ends without a blank line; unexpected unindent.\r
  51 \r
  52 And the tabular representation of boolean or probabilistic prefixes\r
  53 currently renders like this when i view it in man:\r
  54 \r
  55        ┌───────────────────────────┬────────────────────────────┐\r
  56        │Boolean                    │ Probabilistic              │\r
  57        └───────────────────────────┴────────────────────────────┘\r
  58 \r
  59        │          tag: id:         │           from: to:        │\r
  60        │                           │                            │\r
  61        │       thread:     folder: │        subject:    attach‐ │\r
  62        │       path:               │        ment: mimetype:     │\r
  63        └───────────────────────────┴────────────────────────────┘\r
  64 \r
  65 This isn't just ugly: it's confusing, because it seems to imply that\r
  66 some of the prefixes in the left-hand column are somehow related to\r
  67 specific other prefixes in the right-hand column.\r
  68 \r
  69 The Definition List representation introduced by this patch should be\r
  70 simpler for readers to understand, and doesn't have the warning.\r
  71 ---\r
  72  doc/man7/notmuch-search-terms.rst | 16 ++++++----------\r
  73  1 file changed, 6 insertions(+), 10 deletions(-)\r
  74 \r
  75 diff --git a/doc/man7/notmuch-search-terms.rst b/doc/man7/notmuch-search-terms.rst\r
  76 index 223031b..d1c1bd9 100644\r
  77 --- a/doc/man7/notmuch-search-terms.rst\r
  78 +++ b/doc/man7/notmuch-search-terms.rst\r
  79 @@ -215,16 +215,12 @@ Boolean and Probabilistic Prefixes\r
  80  Xapian (and hence notmuch) prefixes are either **boolean**, supporting\r
  81  exact matches like "tag:inbox"  or **probabilistic**, supporting a more flexible **term** based searching. The prefixes currently supported by notmuch are as follows.\r
  82  \r
  83 -+------------------+-----------------------+\r
  84 -|Boolean           |Probabilistic          |\r
  85 -+------------------+-----------------------+\r
  86 -| **tag:** **id:** | **from:** **to:**     |\r
  87 -|**thread:**       |**subject:**           |\r
  88 -|**folder:**       |**attachment:**        |\r
  89 -|**path:**         |**mimetype:**          |\r
  90 -|                  |                       |\r
  91 -+------------------+-----------------------+\r
  92 -\r
  93 +    \r
  94 +Boolean\r
  95 +   **tag:**, **id:**, **thread:**, **folder:**, **path:**\r
  96 +Probabilistic\r
  97 +   **from:**, **to:**, **subject:**, **attachment:**, **mimetype:**\r
  98 +     \r
  99  Terms and phrases\r
 100  -----------------\r
 101  \r
 102 -- \r
 103 2.8.1\r
 104 \r