42/86b1cddde49d1126cefed55cd33c812c7b45a7

   1 Return-Path: <markwalters1009@gmail.com>\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 D8788431FAF\r
   6         for <notmuch@notmuchmail.org>; Fri, 20 Jul 2012 23:34:21 -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.201\r
  10 X-Spam-Level: \r
  11 X-Spam-Status: No, score=0.201 tagged_above=-999 required=5\r
  12         tests=[DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1,\r
  13         FREEMAIL_ENVFROM_END_DIGIT=1, FREEMAIL_FROM=0.001,\r
  14         RCVD_IN_DNSWL_LOW=-0.7] autolearn=disabled\r
  15 Received: from olra.theworths.org ([127.0.0.1])\r
  16         by localhost (olra.theworths.org [127.0.0.1]) (amavisd-new, port 10024)\r
  17         with ESMTP id jIknp0qSr+nK for <notmuch@notmuchmail.org>;\r
  18         Fri, 20 Jul 2012 23:34:21 -0700 (PDT)\r
  19 Received: from mail-we0-f181.google.com (mail-we0-f181.google.com\r
  20         [74.125.82.181]) (using TLSv1 with cipher RC4-SHA (128/128 bits))\r
  21         (No client certificate requested)\r
  22         by olra.theworths.org (Postfix) with ESMTPS id 3D156431FAE\r
  23         for <notmuch@notmuchmail.org>; Fri, 20 Jul 2012 23:34:21 -0700 (PDT)\r
  24 Received: by weyt57 with SMTP id t57so3444218wey.26\r
  25         for <notmuch@notmuchmail.org>; Fri, 20 Jul 2012 23:34:18 -0700 (PDT)\r
  26 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113;\r
  27         h=from:to:cc:subject:date:message-id:x-mailer;\r
  28         bh=5s4OhLfjh/Boq8tRfbWCLWyTAOZkEtw0L+VZ4KIQ7aw=;\r
  29         b=EwsIFotH6cOv3gRbGpmR/fzPosYvQIAsBeU7ojJ8IfpSBmLcV0qLiCa9AmXNuqxtjl\r
  30         nyxG9kvsPwR6WRY7BTWNbuU4WIiWVAhVRCHLguLA/KOJFRWWAJvmGMb8qYv38UoUwdER\r
  31         kuWKiKU6KPpjfnpJUjYx6Ljz5+14HppuhN6LQT5uIBoUdNgGdhJEUHS+EyH1tv0UJCny\r
  32         Kv1nfQjKNdFm4T5SUdjyF41m2NxpX+y9QPz8jsTZAtKIDn0Ct0NXyd8ebgSfCKRDIEng\r
  33         2gWkIEfV3HM84YIa7XQ+PnthMtDkDjIg267c/nI6LfopDarq0a0p9WnT/k/kJCMJV7jB\r
  34         faYg==\r
  35 Received: by 10.180.98.200 with SMTP id ek8mr12843187wib.0.1342852458382;\r
  36         Fri, 20 Jul 2012 23:34:18 -0700 (PDT)\r
  37 Received: from localhost (94-192-233-223.zone6.bethere.co.uk.\r
  38  [94.192.233.223])      by mx.google.com with ESMTPS id\r
  39  t8sm2037305wiy.3.2012.07.20.23.34.16   (version=TLSv1/SSLv3 cipher=OTHER);     Fri,\r
  40  20 Jul 2012 23:34:17 -0700 (PDT)\r
  41 From: Mark Walters <markwalters1009@gmail.com>\r
  42 To: notmuch@notmuchmail.org\r
  43 Subject: [PATCH] man: show: update man page for entire-thread and json.\r
  44 Date: Sat, 21 Jul 2012 07:34:08 +0100\r
  45 Message-Id: <1342852448-8917-1-git-send-email-markwalters1009@gmail.com>\r
  46 X-Mailer: git-send-email 1.7.9.1\r
  47 X-BeenThere: notmuch@notmuchmail.org\r
  48 X-Mailman-Version: 2.1.13\r
  49 Precedence: list\r
  50 List-Id: "Use and development of the notmuch mail system."\r
  51         <notmuch.notmuchmail.org>\r
  52 List-Unsubscribe: <http://notmuchmail.org/mailman/options/notmuch>,\r
  53         <mailto:notmuch-request@notmuchmail.org?subject=unsubscribe>\r
  54 List-Archive: <http://notmuchmail.org/pipermail/notmuch>\r
  55 List-Post: <mailto:notmuch@notmuchmail.org>\r
  56 List-Help: <mailto:notmuch-request@notmuchmail.org?subject=help>\r
  57 List-Subscribe: <http://notmuchmail.org/mailman/listinfo/notmuch>,\r
  58         <mailto:notmuch-request@notmuchmail.org?subject=subscribe>\r
  59 X-List-Received-Date: Sat, 21 Jul 2012 06:34:22 -0000\r
  60 \r
  61 Previously in notmuch show --format=json implied --entire-thread. This\r
  62 is still the default but it is now possible to disable this. Update\r
  63 the manpage to reflect this.\r
  64 ---\r
  65 \r
  66 I didn't update the manpage in the recent patch series. This corrects\r
  67 that omission. (Less cumbersome wording gratefully received)\r
  68 \r
  69 Best wishes\r
  70                                                                                                                              \r
  71 Mark    man/man1/notmuch-show.1 |   16 +++++++++-------\r
  72  1 files changed, 9 insertions(+), 7 deletions(-)\r
  73 \r
  74 diff --git a/man/man1/notmuch-show.1 b/man/man1/notmuch-show.1\r
  75 index b51a54c..5fa590e 100644\r
  76 --- a/man/man1/notmuch-show.1\r
  77 +++ b/man/man1/notmuch-show.1\r
  78 @@ -26,9 +26,9 @@ include\r
  79  .TP 4\r
  80  .B \-\-entire\-thread\r
  81  \r
  82 -By default only those messages that match the search terms will be\r
  83 -displayed. With this option, all messages in the same thread as any\r
  84 -matched message will be displayed.\r
  85 +By default (except when format=json) only those messages that match\r
  86 +the search terms will be displayed. With this option, all messages in\r
  87 +the same thread as any matched message will be displayed.\r
  88  .RE\r
  89  \r
  90  .RS 4\r
  91 @@ -55,11 +55,13 @@ be nested.\r
  92  The output is formatted with Javascript Object Notation (JSON). This\r
  93  format is more robust than the text format for automated\r
  94  processing. The nested structure of multipart MIME messages is\r
  95 -reflected in nested JSON output. JSON output always includes all\r
  96 -messages in a matching thread; in effect\r
  97 +reflected in nested JSON output. By default JSON output includes all\r
  98 +messages in a matching thread; that is, by default,\r
  99  .B \-\-format=json\r
 100 -implies\r
 101 -.B \-\-entire\-thread\r
 102 +sets\r
 103 +.B "\-\-entire\-thread"\r
 104 +The caller can disable this behaviour by setting\r
 105 +.B \-\-entire\-thread=false\r
 106  \r
 107  .RE\r
 108  .RS 4\r
 109 -- \r
 110 1.7.9.1\r
 111 \r