06/f06067d79e703feb833519e20f1b731603e776

   1 Return-Path: <wking@tremily.us>\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 30C0D431FDA\r
   6         for <notmuch@notmuchmail.org>; Sat, 31 May 2014 15:21:07 -0700 (PDT)\r
   7 X-Virus-Scanned: Debian amavisd-new at olra.theworths.org\r
   8 X-Amavis-Alert: BAD HEADER SECTION, Duplicate header field: "References"\r
   9 X-Spam-Flag: NO\r
  10 X-Spam-Score: 0\r
  11 X-Spam-Level: \r
  12 X-Spam-Status: No, score=0 tagged_above=-999 required=5\r
  13         tests=[DKIM_SIGNED=0.1, DKIM_VALID=-0.1, RCVD_IN_DNSWL_NONE=-0.0001]\r
  14         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 JWYJHlp9WfPX for <notmuch@notmuchmail.org>;\r
  18         Sat, 31 May 2014 15:21:02 -0700 (PDT)\r
  19 Received: from qmta04.westchester.pa.mail.comcast.net\r
  20         (qmta04.westchester.pa.mail.comcast.net [76.96.62.40])\r
  21         by olra.theworths.org (Postfix) with ESMTP id 79068431FAE\r
  22         for <notmuch@notmuchmail.org>; Sat, 31 May 2014 15:21:02 -0700 (PDT)\r
  23 Received: from omta14.westchester.pa.mail.comcast.net ([76.96.62.60])\r
  24         by qmta04.westchester.pa.mail.comcast.net with comcast\r
  25         id 8mEw1o0011HzFnQ54mM1zp; Sat, 31 May 2014 22:21:01 +0000\r
  26 Received: from odin.tremily.us ([24.18.63.50])\r
  27         by omta14.westchester.pa.mail.comcast.net with comcast\r
  28         id 8mLz1o00K152l3L3amM06H; Sat, 31 May 2014 22:21:01 +0000\r
  29 Received: from mjolnir.tremily.us (unknown [192.168.0.140])\r
  30         by odin.tremily.us (Postfix) with ESMTPS id 48CA311F0656;\r
  31         Sat, 31 May 2014 15:20:59 -0700 (PDT)\r
  32 Received: (nullmailer pid 13190 invoked by uid 1000);\r
  33         Sat, 31 May 2014 22:20:37 -0000\r
  34 From: "W. Trevor King" <wking@tremily.us>\r
  35 To: notmuch@notmuchmail.org\r
  36 Subject: [PATCH v2 2/6] Add a docstring describing the program\r
  37 Date: Sat, 31 May 2014 15:20:23 -0700\r
  38 Message-Id:\r
  39  <3fd7775920639484fafb788dee39db32c63d9ea0.1401574293.git.wking@tremily.us>\r
  40 X-Mailer: git-send-email 1.9.1.353.gc66d89d\r
  41 In-Reply-To: <cover.1401574293.git.wking@tremily.us>\r
  42 References: <cover.1401574293.git.wking@tremily.us>\r
  43 In-Reply-To: <cover.1401574293.git.wking@tremily.us>\r
  44 References: <cover.1401574293.git.wking@tremily.us>\r
  45 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=comcast.net;\r
  46         s=q20140121; t=1401574861;\r
  47         bh=a1eKs4xsWxjsjLCVuMiDaII0HSbegLDZaixtHeKApa8=;\r
  48         h=Received:Received:Received:Received:From:To:Subject:Date:\r
  49         Message-Id;\r
  50         b=JbSnfjuT9QUrpRr/muSQ9mCqLSEJj/w5XkNwWEO35naMkQMygTE2Ru04g2Bf1nycP\r
  51         PVEmkTX4HslirxEs2nUYxnNLskT0jCSSeUfxnMyfN0biuy1ciKWf7Y5sLlcBbfqKai\r
  52         z/R5lnOAgKst76iN/pzcr4iFbzJhXyEDaK9Z0Sy2kDeNhKl6HvUfUTBss9KgpKbu1w\r
  53         HbawtF3genf3qTNhuxSRZUB1O1/o1gXe6MY5mJcAtQ4W2Lj2apT1K9l8iGHQwAjHa8\r
  54         eohisLUVpItYxMzGEO702DBSbpHa+38wyfiR7lCt50tOfAr6IHvrlTqu9pC8d28zy5\r
  55         QoSnQfc3RsgPQ==\r
  56 Cc: Tomi Ollila <tomi.ollila@iki.fi>\r
  57 X-BeenThere: notmuch@notmuchmail.org\r
  58 X-Mailman-Version: 2.1.13\r
  59 Precedence: list\r
  60 List-Id: "Use and development of the notmuch mail system."\r
  61         <notmuch.notmuchmail.org>\r
  62 List-Unsubscribe: <http://notmuchmail.org/mailman/options/notmuch>,\r
  63         <mailto:notmuch-request@notmuchmail.org?subject=unsubscribe>\r
  64 List-Archive: <http://notmuchmail.org/pipermail/notmuch>\r
  65 List-Post: <mailto:notmuch@notmuchmail.org>\r
  66 List-Help: <mailto:notmuch-request@notmuchmail.org?subject=help>\r
  67 List-Subscribe: <http://notmuchmail.org/mailman/listinfo/notmuch>,\r
  68         <mailto:notmuch-request@notmuchmail.org?subject=subscribe>\r
  69 X-List-Received-Date: Sat, 31 May 2014 22:21:07 -0000\r
  70 \r
  71 From: Carl Worth <cworth@cworth.org>\r
  72 \r
  73 Prefer a docstring to a header comment so we can use it as the\r
  74 ArgumentParser description (formatted with 'nmbug-status --help').\r
  75 Script readers still have it near the top of the file.  Since it's a\r
  76 docstring, use PEP 257's summary-line-and-body format [1].\r
  77 \r
  78 [1]: http://legacy.python.org/dev/peps/pep-0257/#multi-line-docstrings\r
  79 ---\r
  80  devel/nmbug/nmbug-status | 9 ++++++++-\r
  81  1 file changed, 8 insertions(+), 1 deletion(-)\r
  82 \r
  83 diff --git a/devel/nmbug/nmbug-status b/devel/nmbug/nmbug-status\r
  84 index a7c7920..e137a90 100755\r
  85 --- a/devel/nmbug/nmbug-status\r
  86 +++ b/devel/nmbug/nmbug-status\r
  87 @@ -19,6 +19,13 @@\r
  88  # You should have received a copy of the GNU General Public License\r
  89  # along with this program.  If not, see http://www.gnu.org/licenses/ .\r
  90  \r
  91 +"""Generate HTML for one or more notmuch searches.\r
  92 +\r
  93 +Messages matching each search are grouped by thread.  Each message\r
  94 +that contains both a subject and message-id will have the displayed\r
  95 +subject link to the Gmane view of the message.\r
  96 +"""\r
  97 +\r
  98  from __future__ import print_function\r
  99  from __future__ import unicode_literals\r
 100  \r
 101 @@ -255,7 +262,7 @@ class HtmlPage (Page):\r
 102      def _slug(self, string):\r
 103          return self._slug_regexp.sub('-', string)\r
 104  \r
 105 -parser = argparse.ArgumentParser()\r
 106 +parser = argparse.ArgumentParser(description=__doc__)\r
 107  parser.add_argument('--text', help='output plain text format',\r
 108                      action='store_true')\r
 109  parser.add_argument('--config', help='load config from given file',\r
 110 -- \r
 111 1.9.1.353.gc66d89d\r
 112 \r