X-Git-Url: https://git.notmuchmail.org/git?a=blobdiff_plain;f=test%2FREADME;h=d12cff24e2bd7a0796446e76c9e1559da46db1d4;hb=acb079e35726cc421b6a314ab4f26d5eb92feaf1;hp=f9ac6073d97b4739c80b8ba5ec6da00a88d0e154;hpb=22472d9def2f6525a9aac62e6481d8d4fa7db5d0;p=notmuch diff --git a/test/README b/test/README index f9ac6073..d12cff24 100644 --- a/test/README +++ b/test/README @@ -6,6 +6,19 @@ When fixing bugs or enhancing notmuch, you are strongly encouraged to add tests in this directory to cover what you are trying to fix or enhance. +Prerequisites +------------- +Some tests require external dependencies to run. Without them, they +will be skipped, or (rarely) marked failed. Please install these, so +that you know if you break anything. + + - dtach(1) + - emacs(1) + - emacsclient(1) + - gdb(1) + - gpg(1) + - python(1) + Running Tests ------------- The easiest way to run tests is to say "make test", (or simply run the @@ -13,7 +26,8 @@ notmuch-test script). Either command will run all available tests. Alternately, you can run a specific subset of tests by simply invoking one of the executable scripts in this directory, (such as ./search, -./reply, etc.) +./reply, etc). Note that you will probably want "make test-binaries" +before running individual tests. The following command-line options are available when running tests: @@ -42,7 +56,7 @@ The following command-line options are available when running tests: run the tests with this option in parallel. --root=