Adding instructions for running tests in batch mode.

  This makes it easier to test multiple versions of Emacs.

* testing/README.org: Adding instructions for running tests in batch
  mode.

1 files changed, 51 insertions, 0 deletions

diff --git a/testing/README.org b/testing/README.org
index c6c3eef..648a30d 100644
--- a/testing/README.org
+++ b/testing/README.org
@@ -4,6 +4,10 @@
 The following instructions describe how to get started using the
 Org-mode test framework.
 
+* To run the tests interactively
+  :PROPERTIES:
+  :tangle:   no
+  :END:
 1) Install the jump.el testing dependency which is included as a git
    submodule in the org-mode repository.  To do so run the following
    git submodule commands from inside the base of the Org-mode
@@ -57,3 +61,50 @@ Org-mode test framework.
      (org-test-run-all-tests)
    #+end_src
 
+* To run the tests in batch mode
+First tangle this file out to your desktop.
+#+headers: :tangle ~/Desktop/run-org-tests.el
+#+begin_src emacs-lisp :var org-dir=(expand-file-name ".." (file-name-directory (or load-file-name (buffer-file-name))))
+  ;; add to the load path
+  (add-to-list 'load-path (concat org-dir "/lisp/"))
+  (add-to-list 'load-path (concat org-dir "/lisp/testing/"))
+  (add-to-list 'load-path (concat org-dir "/lisp/testing/ert/"))
+  
+  ;; load Org-mode
+  (require 'org)
+  
+  ;; setup the ID locations used in tests
+  (require 'org-id)
+  (org-id-update-id-locations
+   (list (concat org-dir "/testing/examples/babel.org")
+         (concat org-dir "/testing/examples/normal.org")
+         (concat org-dir "/testing/examples/link-in-heading.org")
+         (concat org-dir "/testing/examples/links.org")))
+  
+  ;; ensure that the latest Org-mode is loaded
+  (org-reload)
+  
+  ;; load the test suite
+  (load-file (concat org-dir "/testing/org-test.el"))
+  
+  ;; configure Babel
+  (org-babel-lob-ingest (concat org-dir "/contrib/babel/library-of-babel.org"))
+  (org-babel-do-load-languages
+   'org-babel-load-languages
+   '((emacs-lisp . t)
+     (sh . t)))
+  (setq org-confirm-babel-evaluate nil)
+  
+  ;; run the test suite
+  (org-test-run-all-tests)
+  
+  ;; print the results
+  (with-current-buffer "*ert*"
+    (print (buffer-string)))
+#+end_src
+
+Then run the test suite with the following command which could use any
+version of Emacs.
+#+begin_src sh :results output silent
+  emacs --batch -Q -l ~/Desktop/run-org-tests.el
+#+end_src