org-mode

mirror of https://git.savannah.gnu.org/git/emacs/org-mode.git synced 2024-12-11 09:20:32 +00:00

History

Nicolas Goaziou 172ae310a8 org-export: Define tools for tables, table rows and table cells * contrib/lisp/org-export.el (org-export-table-cell-width, org-export-table-cell-alignment, org-export-table-cell-borders, org-export-table-row-group, org-export-table-has-special-column-p, org-export-table-row-is-special-p, org-export-get-parent-table, org-export-table-dimensions, org-export-table-cell-address, org-export-get-table-cell-at, org-export-table-has-header-p, org-export-table-cell-starts-colgroup-p, org-export-table-cell-ends-colgroup-p, org-export-table-row-starts-rowgroup-p, org-export-table-row-ends-rowgroup-p, org-export-table-row-starts-header-p, org-export-table-row-ends-header-p): New functions. (org-export-table-format-info, org-export-clean-table): Removed functions. (org-export-filter-table-cell-functions, org-export-filter-table-row-functions): New variables. (org-export-filters-alist): Install new filters. (org-export-collect-tree-properties, org-export--skip-p): Mark special rows and cells as ignored. * testing/lisp/test-org-export.el: Add tests.		2012-04-22 19:41:45 +05:30
..
examples	Remove files coming from maint.	2012-03-20 01:50:59 +01:00
jump@820bb7d81b	now using newer version of jump.el -- run $ git submodule update	2010-10-21 13:05:59 +01:00
lisp	org-export: Define tools for tables, table rows and table cells	2012-04-22 19:41:45 +05:30
.gitignore	ignore org-id file generated during testing	2011-11-15 11:19:39 -07:00
org-test-ob-consts.el	Fix the master branch.	2012-03-19 22:01:29 +01:00
org-test.el	Fix the master branch.	2012-03-19 22:01:29 +01:00
README	Small reformatting of testing/README.	2012-04-21 00:59:14 +02:00

README

# -*- mode:org -*-
#+TITLE: Org-mode Testing
#+PROPERTY: results silent

* 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

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 \
        -L lisp/ -L testing/ -L testing/lisp -l lisp/org.el \
        -l lisp/org-id.el -l testing/org-test.el \
        --eval "(progn (org-reload) (setq org-confirm-babel-evaluate nil))" \
        -f org-test-run-batch-tests
#+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

To run the Org-mode test suite from a current Emacs instance simply
load and run the test suite with the following commands.

1) First load the test suite.
   #+BEGIN_SRC emacs-lisp :var here=(buffer-file-name)
     (add-to-list 'load-path (file-name-directory here))
     (require 'org-test)
   #+END_SRC

2) Then run the test suite.
   #+BEGIN_SRC emacs-lisp
     (org-test-run-all-tests)
   #+END_SRC

* 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.