From 48ff1932ce783dde09d6b5864265b84eccfded9f Mon Sep 17 00:00:00 2001
From: Alexei Kornienko <alexei.kornienko@gmail.com>
Date: Sat, 15 Feb 2014 20:59:33 +0200
Subject: [PATCH] Updated doc with debug instructions

This commits adds some info about how you can use debugger in
ceilometer.
Currently testr cannot break into debugger, you have to use
alternative test runner to use it.

Change-Id: Ica68da3da5d8162765a79686d29ffd8d8d9cc85f
---
 doc/source/contributing/source.rst | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/doc/source/contributing/source.rst b/doc/source/contributing/source.rst
index 90cc76697..08b61a5af 100644
--- a/doc/source/contributing/source.rst
+++ b/doc/source/contributing/source.rst
@@ -68,6 +68,13 @@ run through tox_.
 
       $ tox -e py27 -- api.v2
 
+   To debug tests (ie. break into pdb debugger), you can use ''venv'' command::
+
+      $ tox -e venv "python -m unittest discover ceilometer"
+
+   Unfortunately, debugging currently has some limitations:
+   You cannot run a specific test, you have to launch the whole test suite.
+
 .. seealso::
 
    * tox_