[Patch v2 07/11] perf-test: update README

Subject: [Patch v2 07/11] perf-test: update README

Date: Wed, 5 Dec 2012 23:01:44 -0400

To: notmuch@notmuchmail.org

Cc: David Bremner

From: david@tethera.net


From: David Bremner <bremner@debian.org>

Describe new argument parsing and mention cache handling routines.
---
 performance-test/README |   22 +++++++++++++---------
 1 file changed, 13 insertions(+), 9 deletions(-)

diff --git a/performance-test/README b/performance-test/README
index 36f1dac..fd5c977 100644
--- a/performance-test/README
+++ b/performance-test/README
@@ -42,17 +42,21 @@ available performance tests.
 
 Alternately, you can run a specific subset of tests by simply invoking
 one of the executable scripts in this directory, (such as ./basic).
+Each test script supports the following arguments
+
+--small / --medium / --large	Choose corpus size.
+--debug				Enable debugging. In particular don't delete
+				temporary directories.
 
 Writing tests
 -------------
 
-Have a look at "basic" for an example.
-
-add_email_corpus takes arguments "--small" and "--medium" for when you
-want smaller subsets of the corpus to check.
-
-time_done does the cleanup; comment it out or define "$debug" to leave
-the temporary files around.
+Have a look at "basic" for an example. Sourcing "perf-test-lib.sh" is
+mandatory.  Utility functions include
 
-Currently there is no option processing (e.g. --debug) in the
-performance tests.
+- 'add_email_corpus' unpacks a set of messages and adds them to the database.
+- 'cache_database': makes a snapshot of the current database
+- 'uncache_database': forces the next 'add_email_corpus' to rebuild the
+  database.
+- 'time_done' does the cleanup; comment it out or pass --debug to the
+  script to leave the temporary files around.
-- 
1.7.10.4


Thread: