[Emacs-diffs] trunk r114776: * ert.texi (Running Tests Interactively): Adapt examle output.

[Michael Albinus]

------------------------------------------------------------
revno: 114776
revision-id: address@hidden
parent: address@hidden
committer: Michael Albinus <address@hidden>
branch nick: trunk
timestamp: Thu 2013-10-24 09:40:05 +0200
message:
  * ert.texi (Running Tests Interactively): Adapt examle output.
  (Tests and Their Environment): Mention skip-unless.
modified:
  doc/misc/ChangeLog             changelog-20091113204419-o5vbwnq5f7feedwu-6331
  doc/misc/ert.texi              ert.texi-20110112160650-056hnl9qhpjvjicy-7

=== modified file 'doc/misc/ChangeLog'
--- a/doc/misc/ChangeLog        2013-10-23 17:20:09 +0000
+++ b/doc/misc/ChangeLog        2013-10-24 07:40:05 +0000
@@ -1,3 +1,8 @@
+2013-10-24  Michael Albinus  <address@hidden>
+
+       * ert.texi (Running Tests Interactively): Adapt examle output.
+       (Tests and Their Environment): Mention skip-unless.
+
 2013-10-23  Glenn Morris  <address@hidden>
 
        * dired-x.texi, ebrowse.texi, ede.texi, eieio.texi, eshell.texi:

=== modified file 'doc/misc/ert.texi'
--- a/doc/misc/ert.texi 2013-01-02 16:13:04 +0000
+++ b/doc/misc/ert.texi 2013-10-24 07:40:05 +0000
@@ -183,9 +183,10 @@
 
 @example
 Selector: t
-Passed: 31
-Failed: 2 (2 unexpected)
-Total:  33/33
+Passed:  31
+Skipped: 0
+Failed:  2 (2 unexpected)
+Total:   33/33
 
 Started at:   2008-09-11 08:39:25-0700
 Finished.
@@ -454,6 +455,19 @@
 @node Tests and Their Environment
 @section Tests and Their Environment
 
+Sometimes, it doesn't make sense to run a test due to missing
+preconditions.  A required Emacs feature might not be compiled in, the
+function to be tested could call an external binary which might not be
+available on the test machine, you name it.  In this case, the macro
address@hidden could be used to skip the test:
+
address@hidden
+(ert-deftest test-dbus ()
+  "A test that checks D-BUS functionality."
+  (skip-unless (featurep 'dbusbind))
+  ...)
address@hidden lisp
+
 The outcome of running a test should not depend on the current state
 of the environment, and each test should leave its environment in the
 same state it found it in.  In particular, a test should not depend on