1 files changed, 31 insertions, 0 deletions
diff --git a/doc/developers/running-unit-tests.rst b/doc/developers/running-unit-tests.rst
new file mode 100644
index 0000000..f75cb81
--- /dev/null
+++ b/doc/developers/running-unit-tests.rst
@@ -0,0 +1,31 @@
+Running unit tests
+==================
+The tests are dependent on the pear packages HTTP_Request2 and Stream_Var.
+
+Install them with: ::
+  $ pear install HTTP_Request2
+  $ pear install Stream_Var
+
+Go to the SemanticScuttle ``tests`` directory and run ``phpunit``::
+
+  $ cd tests
+  $ phpunit .
+
+also remember the ``--verbose`` parameter to PHPUnit.
+
+If you want to run a specific test class only: ::
+
+ $ cd tests
+ $ phpunit BookmarksTest.php
+
+If you need to test one method only: ::
+
+ $ cd tests
+ $ phpunit --filter BookmarkTest::testUnificationOfBookmarks tests/BookmarkTest.php
+
+
+Caveats
+-------
+Having debugging enabled and database driver "``mysql4``" activated
+will lead to failing tests because of ``FOUND_ROWS()`` usage, which
+does not work nicely with database debugging.