[PATCH 1/3] test: update documentation for test_emacs in test/README

diff --git a/a6/091e6344bbb9074e3114667f2184ad652015db b/a6/091e6344bbb9074e3114667f2184ad652015db
new file mode 100644 (file)
index 0000000..83646f8
--- /dev/null
+++ b/a6/091e6344bbb9074e3114667f2184ad652015db
@@ -0,0 +1,103 @@
+Return-Path: <dmitry.kurochkin@gmail.com>\r
+X-Original-To: notmuch@notmuchmail.org\r
+Delivered-To: notmuch@notmuchmail.org\r
+Received: from localhost (localhost [127.0.0.1])\r
+       by olra.theworths.org (Postfix) with ESMTP id 3766A429E21\r
+       for <notmuch@notmuchmail.org>; Sun,  3 Jul 2011 19:00:32 -0700 (PDT)\r
+X-Virus-Scanned: Debian amavisd-new at olra.theworths.org\r
+X-Spam-Flag: NO\r
+X-Spam-Score: -0.799\r
+X-Spam-Level: \r
+X-Spam-Status: No, score=-0.799 tagged_above=-999 required=5\r
+       tests=[DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1,\r
+       FREEMAIL_FROM=0.001, RCVD_IN_DNSWL_LOW=-0.7] autolearn=disabled\r
+Received: from olra.theworths.org ([127.0.0.1])\r
+       by localhost (olra.theworths.org [127.0.0.1]) (amavisd-new, port 10024)\r
+       with ESMTP id i2KOBvA1JxxG for <notmuch@notmuchmail.org>;\r
+       Sun,  3 Jul 2011 19:00:29 -0700 (PDT)\r
+Received: from mail-bw0-f53.google.com (mail-bw0-f53.google.com\r
+       [209.85.214.53]) (using TLSv1 with cipher RC4-SHA (128/128 bits))\r
+       (No client certificate requested)\r
+       by olra.theworths.org (Postfix) with ESMTPS id A4AEF431FB6\r
+       for <notmuch@notmuchmail.org>; Sun,  3 Jul 2011 19:00:29 -0700 (PDT)\r
+Received: by bwg12 with SMTP id 12so4396763bwg.26\r
+       for <notmuch@notmuchmail.org>; Sun, 03 Jul 2011 19:00:28 -0700 (PDT)\r
+DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=gamma;\r
+       h=from:to:cc:subject:date:message-id:x-mailer;\r
+       bh=W4iOjwCKYCdhIcFaOVlbEbkQYxEfuSc97x/nHrLfe1M=;\r
+       b=gWosMqUV9wYFdUiwUxnEy6vTEce1P23nSNXUI7KrF1+0zwn79Dlj8mEBfPljzyHVKg\r
+       2pIloNXqQwbsLXgaYkUY28/rmvnIPAoqbrgOwbv/eqSAq22jTwXozSIx/rlcBoi2/n1m\r
+       lBrzfR3fq04d2DGTDtvO95ChSU8tqbH+BveHM=\r
+Received: by 10.204.79.67 with SMTP id o3mr52318bkk.19.1309744828018;\r
+       Sun, 03 Jul 2011 19:00:28 -0700 (PDT)\r
+Received: from localhost ([91.144.186.21])\r
+       by mx.google.com with ESMTPS id t9sm5108321bkn.8.2011.07.03.19.00.26\r
+       (version=TLSv1/SSLv3 cipher=OTHER);\r
+       Sun, 03 Jul 2011 19:00:27 -0700 (PDT)\r
+From: Dmitry Kurochkin <dmitry.kurochkin@gmail.com>\r
+To: notmuch@notmuchmail.org\r
+Subject: [PATCH 1/3] test: update documentation for test_emacs in test/README\r
+Date: Mon,  4 Jul 2011 05:59:01 +0400\r
+Message-Id: <1309744743-8556-1-git-send-email-dmitry.kurochkin@gmail.com>\r
+X-Mailer: git-send-email 1.7.5.4\r
+X-BeenThere: notmuch@notmuchmail.org\r
+X-Mailman-Version: 2.1.13\r
+Precedence: list\r
+List-Id: "Use and development of the notmuch mail system."\r
+       <notmuch.notmuchmail.org>\r
+List-Unsubscribe: <http://notmuchmail.org/mailman/options/notmuch>,\r
+       <mailto:notmuch-request@notmuchmail.org?subject=unsubscribe>\r
+List-Archive: <http://notmuchmail.org/pipermail/notmuch>\r
+List-Post: <mailto:notmuch@notmuchmail.org>\r
+List-Help: <mailto:notmuch-request@notmuchmail.org?subject=help>\r
+List-Subscribe: <http://notmuchmail.org/mailman/listinfo/notmuch>,\r
+       <mailto:notmuch-request@notmuchmail.org?subject=subscribe>\r
+X-List-Received-Date: Mon, 04 Jul 2011 02:00:32 -0000\r
+\r
+Update test_emacs documentation in test/README according to the latest\r
+changes in emacs tests.  Move the note regarding setting variables\r
+from test/emacs to test/README.\r
+---\r
+ test/README |   10 +++++++---\r
+ test/emacs  |    5 -----\r
+ 2 files changed, 7 insertions(+), 8 deletions(-)\r
+\r
+diff --git a/test/README b/test/README\r
+index f9ac607..a245bf1 100644\r
+--- a/test/README\r
++++ b/test/README\r
+@@ -181,9 +181,13 @@ library for your script to use.\r
+ \r
+    This function executes the provided emacs lisp script within\r
+    emacs. The script can be a sequence of emacs lisp expressions,\r
+-   (that is, they will be evaluated within a progn form). The lisp\r
+-   expressions can call `message' to generate output on stdout to be\r
+-   examined by the calling test script.\r
++   (that is, they will be evaluated within a progn form). Emacs\r
++   stdout and stderr is not available, the common way to get output\r
++   is to save it to a file. There are some auxiliary functions\r
++   useful in emacs tests provided in test-lib.el. Do not use `setq'\r
++   for setting variables in Emacs tests because it affects other\r
++   tests that may run in the same Emacs instance.  Use `let' instead\r
++   so the scope of the changed variables is limited to a single test.\r
+ \r
+  test_done\r
+ \r
+diff --git a/test/emacs b/test/emacs\r
+index 53f455a..f465e2b 100755\r
+--- a/test/emacs\r
++++ b/test/emacs\r
+@@ -1,10 +1,5 @@\r
+ #!/usr/bin/env bash\r
+ \r
+-# Note: do not use `setq' for setting variables in Emacs tests because\r
+-# it affects other tests that may run in the same Emacs instance.  Use\r
+-# `let' instead so the scope of the changed variables is limited to a\r
+-# single test.\r
+-\r
+ test_description="emacs interface"\r
+ . test-lib.sh\r
+ \r
+-- \r
+1.7.5.4\r
+\r