92/2d536ddb452cf268ad791f8e4204019f7b82af

   1 Return-Path: <glasse@cs.rpi.edu>\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 51076431FB6\r
   6         for <notmuch@notmuchmail.org>; Mon, 16 Jan 2012 10:53:43 -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.54\r
  10 X-Spam-Level: \r
  11 X-Spam-Status: No, score=-0.54 tagged_above=-999 required=5\r
  12         tests=[DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1,\r
  13         RCVD_IN_BL_SPAMCOP_NET=1.246, RCVD_IN_DNSWL_MED=-2.3,\r
  14         RCVD_IN_SORBS_WEB=0.614] 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 HRVaUYogjJzV for <notmuch@notmuchmail.org>;\r
  18         Mon, 16 Jan 2012 10:53:42 -0800 (PST)\r
  19 Received: from cliffclavin.cs.rpi.edu (cliffclavin.cs.rpi.edu\r
  20  [128.113.126.25])      (using TLSv1 with cipher DHE-RSA-AES256-SHA (256/256 bits))\r
  21         (No client certificate requested)       by olra.theworths.org (Postfix) with ESMTPS\r
  22  id AC773431FAF for <notmuch@notmuchmail.org>; Mon, 16 Jan 2012 10:53:42 -0800\r
  23  (PST)\r
  24 X-Hash:\r
  25  S|1df53241a45db89f822e5e8f085d062f53b26bd8|a8986efba4e858f527f7af5e8e560960\r
  26 X-Countries: Cameroon, United States\r
  27 X-SMTP-From: accepted <glasse@cs.rpi.edu> [195.24.209.20] [195.24.209.20]\r
  28         (localhost) {Cameroon}\r
  29 DKIM-Signature: v=1; a=rsa-sha1; c=relaxed/relaxed; d=cs.rpi.edu; h=from\r
  30         :to:cc:subject:date:message-id; s=default; i=glasse@cs.rpi.edu;\r
  31         t=1326740020; x=1327344820; l=1134; bh=oN1hhely2HcN0RX9CjUDIG/s\r
  32         YyI=; b=ND+Ig2McCgRX+S0Q4UyeM9+NEOlYqB0JWw4gGY29ZTWaVci4hYupZxMI\r
  33         DeYvxRj6fuCT+0hyiP2b57xoxr+dinAji5cl2JqFoD1DjBJNPqf14nb1J9uPB0kn\r
  34         kAUeU3GuXTbas6WhvV/ZsjVpqfSmSWMEaI7dg6XQP9Qa53X+5H4=\r
  35 DomainKey-Signature: a=rsa-sha1; c=nofws; d=cs.rpi.edu; h=from:to:cc\r
  36         :subject:date:message-id; q=dns; s=default; b=VLTmV7HAn0X/6R1d/k\r
  37         j1gBgSBDlNZcmWssZyaRsMrLUY0Qp7V8VonelbxXNjBx3uHc0GfxmmLohcznky/d\r
  38         mMM6hmiXUl1rekWo5QqztCC5bihAJujx3LyUH/5fE6063iHtFfqhO6aCoBPc3wkV\r
  39         yvSfnwFa5boGz3dib7fyurLSM=\r
  40 X-Spam-Info: -2.7; ALL_TRUSTED,AWL,BAYES_00\r
  41 X-Spam-Scanned-By: cliffclavin.cs.rpi.edu using SpamAssassin 3.2.5 (hard limit\r
  42         15)\r
  43 Authentication-Results: cliffclavin.cs.rpi.edu;\r
  44         DKIM=neutral (none) header.from=glasse@cs.rpi.edu;\r
  45         SPF=neutral (mfrom;\r
  46         Mechanism '?all' matched) smtp.mail=glasse@cs.rpi.edu\r
  47 X-Auth-Passed: cliffclavin.cs.rpi.edu:q0GIrHNB038990 Auth:glasse\r
  48 X-Virus-Scanned-By: cliffclavin.cs.rpi.edu\r
  49 Received: from localhost ([195.24.209.20]) (authenticated bits=0)\r
  50         by cliffclavin.cs.rpi.edu (8.14.3/8.14.3) with ESMTP id q0GIrHNB038990\r
  51         (version=TLSv1/SSLv3 cipher=DHE-RSA-AES128-SHA bits=128 verify=NO);\r
  52         Mon, 16 Jan 2012 13:53:35 -0500 (EST)\r
  53         (envelope-from glasse@cs.rpi.edu)\r
  54 From: Ethan Glasser-Camp <glasse@cs.rpi.edu>\r
  55 To: notmuch@notmuchmail.org\r
  56 Subject: [PATCH v2] Document external dependencies in the test suite\r
  57 Date: Mon, 16 Jan 2012 13:52:47 -0500\r
  58 Message-Id: <1326739967-23823-1-git-send-email-glasse@cs.rpi.edu>\r
  59 X-Mailer: git-send-email 1.7.5.4\r
  60 X-Scanned-By: MIMEDefang 2.67 on 128.113.126.25\r
  61 Cc: Ethan Glasser-Camp <ethan@betacantrips.com>\r
  62 X-BeenThere: notmuch@notmuchmail.org\r
  63 X-Mailman-Version: 2.1.13\r
  64 Precedence: list\r
  65 List-Id: "Use and development of the notmuch mail system."\r
  66         <notmuch.notmuchmail.org>\r
  67 List-Unsubscribe: <http://notmuchmail.org/mailman/options/notmuch>,\r
  68         <mailto:notmuch-request@notmuchmail.org?subject=unsubscribe>\r
  69 List-Archive: <http://notmuchmail.org/pipermail/notmuch>\r
  70 List-Post: <mailto:notmuch@notmuchmail.org>\r
  71 List-Help: <mailto:notmuch-request@notmuchmail.org?subject=help>\r
  72 List-Subscribe: <http://notmuchmail.org/mailman/listinfo/notmuch>,\r
  73         <mailto:notmuch-request@notmuchmail.org?subject=subscribe>\r
  74 X-List-Received-Date: Mon, 16 Jan 2012 18:53:43 -0000\r
  75 \r
  76 From: Ethan Glasser-Camp <ethan@betacantrips.com>\r
  77 \r
  78 Add an explicit note to the README explaining what programs are\r
  79 necessary and the perhaps-surprising behavior of skipping tests if\r
  80 they aren't present.\r
  81 \r
  82 Signed-off-by: Ethan Glasser-Camp <ethan@betacantrips.com>\r
  83 ---\r
  84 \r
  85 v2 suggested by Dmitry Kurochkin: document all the dependencies.\r
  86 \r
  87  test/README |   13 +++++++++++++\r
  88  1 files changed, 13 insertions(+), 0 deletions(-)\r
  89 \r
  90 diff --git a/test/README b/test/README\r
  91 index bde6db0..44ff653 100644\r
  92 --- a/test/README\r
  93 +++ b/test/README\r
  94 @@ -6,6 +6,19 @@ When fixing bugs or enhancing notmuch, you are strongly encouraged to\r
  95  add tests in this directory to cover what you are trying to fix or\r
  96  enhance.\r
  97  \r
  98 +Prerequisites\r
  99 +-------------\r
 100 +Some tests require external dependencies to run. Without them, they\r
 101 +will be skipped, or (rarely) marked failed. Please install these, so\r
 102 +that you know if you break anything.\r
 103 +\r
 104 +  - dtach(1)\r
 105 +  - emacs(1)\r
 106 +  - emacsclient(1)\r
 107 +  - gdb(1)\r
 108 +  - gpg(1)\r
 109 +  - python(1)\r
 110 +\r
 111  Running Tests\r
 112  -------------\r
 113  The easiest way to run tests is to say "make test", (or simply run the\r
 114 -- \r
 115 1.7.5.4\r
 116 \r