From b857974f7db54600f304e6e8b90260f76d27f3d4 Mon Sep 17 00:00:00 2001 From: Bastien Guerry Date: Sat, 21 Apr 2012 00:59:14 +0200 Subject: [PATCH] Small reformatting of testing/README. --- testing/README | 19 +++++++++++++------ 1 file changed, 13 insertions(+), 6 deletions(-) diff --git a/testing/README b/testing/README index f4253c7cf..a81efa022 100644 --- a/testing/README +++ b/testing/README @@ -1,17 +1,20 @@ # -*- mode:org -*- -#+Title: Org-mode Testing -#+Property: results silent +#+TITLE: Org-mode Testing +#+PROPERTY: results silent + +* Dependencies -* dependencies The only dependency is [[http://www.emacswiki.org/emacs/ErtTestLibrary][ERT]] the Emacs testing library which ships with Emacs24. If you are running an older version of Emacs and don't already have ERT installed it can be installed from its old [[https://github.com/ohler/ert][git repository]]. -* non-interactive batch testing from the command line +* Non-interactive batch testing from the command line + The simplest way to run the Org-mode test suite is from the command line with the following invocation. Note that the paths below are relative to the base of the Org-mode directory. + #+BEGIN_SRC sh :dir (expand-file-name "..") # For Emacs earlier than 24, add -L /path/to/ert emacs -Q --batch \ @@ -22,13 +25,15 @@ relative to the base of the Org-mode directory. #+END_SRC The options in the above command are explained below. + | -Q | ignores any personal configuration ensuring a vanilla Emacs instance is used | | --batch | runs Emacs in "batch" mode with no gui and termination after execution | | -l | loads Org-mode and the org mode test suite defined in testing/org-test.el | | --eval | reloads Org-mode and allows evaluation of code blocks by the tests | | -f | actually runs the tests using the `org-test-run-batch-tests' function | -* interactive testing from within Emacs +* Interactive testing from within Emacs + To run the Org-mode test suite from a current Emacs instance simply load and run the test suite with the following commands. @@ -42,7 +47,9 @@ load and run the test suite with the following commands. #+BEGIN_SRC emacs-lisp (org-test-run-all-tests) #+END_SRC -* troubleshooting + +* Troubleshooting + - If the value of the =org-babel-no-eval-on-ctrl-c-ctrl-c= is non-nil then it will result in some test failure, as there are tests which rely on this behavior.